Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 0c53fee9 authored by Hans Verkuil's avatar Hans Verkuil Committed by Mauro Carvalho Chehab
Browse files

[media] vidioc-enum-dv-timings.xml: explicitly state that pad and reserved should be zeroed 



The ENUM_DV_TIMINGS documentation did not clearly state that the pad and reserved
fields should be zeroed (pad only when used with a video device node).

Signed-off-by: default avatarHans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
parent 0be67c40

Documentation/DocBook/media/v4l/vidioc-enum-dv-timings.xml

+3 −2
Original line number Diff line number Diff line
@@ -61,8 +61,9 @@ of known supported timings. Call &VIDIOC-DV-TIMINGS-CAP; to check if it also sup 
standards or even custom timings that are not in this list.</para>



    <para>To query the available timings, applications initialize the

<structfield>index</structfield> field and zero the reserved array of &v4l2-enum-dv-timings;

and call the <constant>VIDIOC_ENUM_DV_TIMINGS</constant> ioctl on a video node with a

<structfield>index</structfield> field, set the <structfield>pad</structfield> field to 0,

zero the reserved array of &v4l2-enum-dv-timings; and call the

<constant>VIDIOC_ENUM_DV_TIMINGS</constant> ioctl on a video node with a

pointer to this structure. Drivers fill the rest of the structure or return an

&EINVAL; when the index is out of bounds. To enumerate all supported DV timings,

applications shall begin at index zero, incrementing by one until the