V4L: docbook documentation for struct v4l2_create_buffers
Commit Message
Signed-off-by: Guennadi Liakhovetski <g.liakhovetski@gmx.de>
---
Obviously, this goes on top of the "multi-size buffers" patch series.
Thanks again to Sakari for the idea.
drivers/media/video/v4l2-compat-ioctl32.c | 13 +++++++++++--
include/linux/videodev2.h | 14 +++++++++++---
2 files changed, 22 insertions(+), 5 deletions(-)
@@ -159,11 +159,20 @@ struct v4l2_format32 {
} fmt;
};
+/**
+ * struct v4l2_create_buffers32 - VIDIOC_CREATE_BUFS32 argument
+ * @index: on return, index of the first created buffer
+ * @count: entry: number of requested buffers,
+ * return: number of created buffers
+ * @memory: buffer memory type
+ * @format: frame format, for which buffers are requested
+ * @reserved: future extensions
+ */
struct v4l2_create_buffers32 {
- __u32 index; /* output: buffers index...index + count - 1 have been created */
+ __u32 index;
__u32 count;
enum v4l2_memory memory;
- struct v4l2_format32 format; /* filled in by the user, plane sizes calculated by the driver */
+ struct v4l2_format32 format;
__u32 reserved[8];
};
@@ -2102,12 +2102,20 @@ struct v4l2_dbg_chip_ident {
__u32 revision; /* chip revision, chip specific */
} __attribute__ ((packed));
-/* VIDIOC_CREATE_BUFS */
+/**
+ * struct v4l2_create_buffers - VIDIOC_CREATE_BUFS argument
+ * @index: on return, index of the first created buffer
+ * @count: entry: number of requested buffers,
+ * return: number of created buffers
+ * @memory: buffer memory type
+ * @format: frame format, for which buffers are requested
+ * @reserved: future extensions
+ */
struct v4l2_create_buffers {
- __u32 index; /* output: buffers index...index + count - 1 have been created */
+ __u32 index;
__u32 count;
enum v4l2_memory memory;
- struct v4l2_format format; /* "type" is used always, the rest if sizeimage == 0 */
+ struct v4l2_format format;
__u32 reserved[8];
};