X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=Documentation%2Fmedia%2Fuapi%2Fv4l%2Fvidioc-g-parm.rst;h=689b5d92aeaee40198512630b1640a5efa600d22;hb=be831b34c2182731df77710e2fb8130060b1012f;hp=7116e0decddc817021fb8216b79e48f608be4a43;hpb=43a0a98aa8da71583f84b84fd72e265c24d4c5f8;p=deliverable%2Flinux.git diff --git a/Documentation/media/uapi/v4l/vidioc-g-parm.rst b/Documentation/media/uapi/v4l/vidioc-g-parm.rst index 7116e0decddc..689b5d92aeae 100644 --- a/Documentation/media/uapi/v4l/vidioc-g-parm.rst +++ b/Documentation/media/uapi/v4l/vidioc-g-parm.rst @@ -15,7 +15,11 @@ VIDIOC_G_PARM - VIDIOC_S_PARM - Get or set streaming parameters Synopsis ======== -.. cpp:function:: int ioctl( int fd, int request, v4l2_streamparm *argp ) +.. c:function:: int ioctl( int fd, VIDIOC_G_PARM, v4l2_streamparm *argp ) + :name: VIDIOC_G_PARM + +.. c:function:: int ioctl( int fd, VIDIOC_S_PARM, v4l2_streamparm *argp ) + :name: VIDIOC_S_PARM Arguments @@ -24,9 +28,6 @@ Arguments ``fd`` File descriptor returned by :ref:`open() `. -``request`` - VIDIOC_G_PARM, VIDIOC_S_PARM - ``argp`` @@ -46,11 +47,13 @@ section discussing the :ref:`read() ` function. To get and set the streaming parameters applications call the :ref:`VIDIOC_G_PARM ` and :ref:`VIDIOC_S_PARM ` ioctl, respectively. They take a -pointer to a struct :ref:`struct v4l2_streamparm ` which contains a +pointer to a struct :c:type:`v4l2_streamparm` which contains a union holding separate parameters for input and output devices. -.. _v4l2-streamparm: +.. tabularcolumns:: |p{3.5cm}|p{3.5cm}|p{3.5cm}|p{7.0cm}| + +.. c:type:: v4l2_streamparm .. flat-table:: struct v4l2_streamparm :header-rows: 0 @@ -66,7 +69,7 @@ union holding separate parameters for input and output devices. - - The buffer (stream) type, same as struct - :ref:`v4l2_format ` ``type``, set by the + :c:type:`v4l2_format` ``type``, set by the application. See :ref:`v4l2-buf-type` - .. row 2 @@ -81,7 +84,7 @@ union holding separate parameters for input and output devices. - .. row 3 - - - struct :ref:`v4l2_captureparm ` + - struct :c:type:`v4l2_captureparm` - ``capture`` @@ -91,7 +94,7 @@ union holding separate parameters for input and output devices. - .. row 4 - - - struct :ref:`v4l2_outputparm ` + - struct :c:type:`v4l2_outputparm` - ``output`` @@ -109,7 +112,9 @@ union holding separate parameters for input and output devices. -.. _v4l2-captureparm: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + +.. c:type:: v4l2_captureparm .. flat-table:: struct v4l2_captureparm :header-rows: 0 @@ -135,7 +140,7 @@ union holding separate parameters for input and output devices. - .. row 3 - - struct :ref:`v4l2_fract ` + - struct :c:type:`v4l2_fract` - ``timeperframe`` @@ -146,7 +151,7 @@ union holding separate parameters for input and output devices. Applications store here the desired frame period, drivers return the actual frame period, which must be greater or equal to the nominal frame period determined by the current video standard - (struct :ref:`v4l2_standard ` ``frameperiod`` + (struct :c:type:`v4l2_standard` ``frameperiod`` field). Changing the video standard (also implicitly by switching the video input) may reset this parameter to the nominal frame period. To reset manually applications can just set this field to @@ -190,7 +195,9 @@ union holding separate parameters for input and output devices. -.. _v4l2-outputparm: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + +.. c:type:: v4l2_outputparm .. flat-table:: struct v4l2_outputparm :header-rows: 0 @@ -216,7 +223,7 @@ union holding separate parameters for input and output devices. - .. row 3 - - struct :ref:`v4l2_fract ` + - struct :c:type:`v4l2_fract` - ``timeperframe`` @@ -234,7 +241,7 @@ union holding separate parameters for input and output devices. Applications store here the desired frame period, drivers return the actual frame period, which must be greater or equal to the nominal frame period determined by the current video standard - (struct :ref:`v4l2_standard ` ``frameperiod`` + (struct :c:type:`v4l2_standard` ``frameperiod`` field). Changing the video standard (also implicitly by switching the video output) may reset this parameter to the nominal frame period. To reset manually applications can just set this field to @@ -278,6 +285,8 @@ union holding separate parameters for input and output devices. +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. _parm-caps: .. flat-table:: Streaming Parameters Capabilites @@ -297,6 +306,8 @@ union holding separate parameters for input and output devices. +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. _parm-flags: .. flat-table:: Capture Parameters Flags