Add a small description and document struct fields of
drm_mode_get_plane.

Signed-off-by: Leandro Ribeiro <[email protected]>
---
 include/uapi/drm/drm_mode.h | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/include/uapi/drm/drm_mode.h b/include/uapi/drm/drm_mode.h
index a5e76aa06ad5..8fa6495cd948 100644
--- a/include/uapi/drm/drm_mode.h
+++ b/include/uapi/drm/drm_mode.h
@@ -312,16 +312,38 @@ struct drm_mode_set_plane {
        __u32 src_w;
 };

+/**
+ * struct drm_mode_get_plane - Get plane metadata.
+ *
+ * Userspace can perform a GETPLANE ioctl to retrieve information about a
+ * plane.
+ */
 struct drm_mode_get_plane {
+       /** @plane_id: Object ID of the plane. */
        __u32 plane_id;

+       /** @crtc_id: Object ID of the current CRTC. */
        __u32 crtc_id;
+       /** @fb_id: Object ID of the current fb. */
        __u32 fb_id;

+       /**
+        * @possible_crtcs: Bitmask of CRTC's compatible with the plane. CRTC's
+        * are created and they receive an index, which corresponds to their
+        * position in the bitmask. CRTC with index 0 will be in bit 0, and so
+        * on. To learn how to find out the index of a certain CRTC, please see
+        * :ref:`crtc_index`.
+        */
        __u32 possible_crtcs;
+       /** @gamma_size: Number of entries of the legacy gamma lookup table. */
        __u32 gamma_size;

+       /** @count_format_types: Number of formats. */
        __u32 count_format_types;
+       /**
+        * @format_type_ptr: Pointer to ``__u32`` array of formats that are
+        * supported by the plane. These formats do not require modifiers.
+        */
        __u64 format_type_ptr;
 };

--
2.31.1

_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel

Reply via email to