162306a36Sopenharmony_ci.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later 262306a36Sopenharmony_ci.. c:namespace:: V4L 362306a36Sopenharmony_ci 462306a36Sopenharmony_ci.. _VIDIOC_G_STD: 562306a36Sopenharmony_ci 662306a36Sopenharmony_ci************************************************************************** 762306a36Sopenharmony_ciioctl VIDIOC_G_STD, VIDIOC_S_STD, VIDIOC_SUBDEV_G_STD, VIDIOC_SUBDEV_S_STD 862306a36Sopenharmony_ci************************************************************************** 962306a36Sopenharmony_ci 1062306a36Sopenharmony_ciName 1162306a36Sopenharmony_ci==== 1262306a36Sopenharmony_ci 1362306a36Sopenharmony_ciVIDIOC_G_STD - VIDIOC_S_STD - VIDIOC_SUBDEV_G_STD - VIDIOC_SUBDEV_S_STD - Query or select the video standard of the current input 1462306a36Sopenharmony_ci 1562306a36Sopenharmony_ciSynopsis 1662306a36Sopenharmony_ci======== 1762306a36Sopenharmony_ci 1862306a36Sopenharmony_ci.. c:macro:: VIDIOC_G_STD 1962306a36Sopenharmony_ci 2062306a36Sopenharmony_ci``int ioctl(int fd, VIDIOC_G_STD, v4l2_std_id *argp)`` 2162306a36Sopenharmony_ci 2262306a36Sopenharmony_ci.. c:macro:: VIDIOC_S_STD 2362306a36Sopenharmony_ci 2462306a36Sopenharmony_ci``int ioctl(int fd, VIDIOC_S_STD, const v4l2_std_id *argp)`` 2562306a36Sopenharmony_ci 2662306a36Sopenharmony_ci.. c:macro:: VIDIOC_SUBDEV_G_STD 2762306a36Sopenharmony_ci 2862306a36Sopenharmony_ci``int ioctl(int fd, VIDIOC_SUBDEV_G_STD, v4l2_std_id *argp)`` 2962306a36Sopenharmony_ci 3062306a36Sopenharmony_ci.. c:macro:: VIDIOC_SUBDEV_S_STD 3162306a36Sopenharmony_ci 3262306a36Sopenharmony_ci``int ioctl(int fd, VIDIOC_SUBDEV_S_STD, const v4l2_std_id *argp)`` 3362306a36Sopenharmony_ci 3462306a36Sopenharmony_ciArguments 3562306a36Sopenharmony_ci========= 3662306a36Sopenharmony_ci 3762306a36Sopenharmony_ci``fd`` 3862306a36Sopenharmony_ci File descriptor returned by :c:func:`open()`. 3962306a36Sopenharmony_ci 4062306a36Sopenharmony_ci``argp`` 4162306a36Sopenharmony_ci Pointer to :c:type:`v4l2_std_id`. 4262306a36Sopenharmony_ci 4362306a36Sopenharmony_ciDescription 4462306a36Sopenharmony_ci=========== 4562306a36Sopenharmony_ci 4662306a36Sopenharmony_ciTo query and select the current video standard applications use the 4762306a36Sopenharmony_ci:ref:`VIDIOC_G_STD <VIDIOC_G_STD>` and :ref:`VIDIOC_S_STD <VIDIOC_G_STD>` ioctls which take a pointer to a 4862306a36Sopenharmony_ci:ref:`v4l2_std_id <v4l2-std-id>` type as argument. :ref:`VIDIOC_G_STD <VIDIOC_G_STD>` 4962306a36Sopenharmony_cican return a single flag or a set of flags as in struct 5062306a36Sopenharmony_ci:c:type:`v4l2_standard` field ``id``. The flags must be 5162306a36Sopenharmony_ciunambiguous such that they appear in only one enumerated 5262306a36Sopenharmony_cistruct :c:type:`v4l2_standard` structure. 5362306a36Sopenharmony_ci 5462306a36Sopenharmony_ci:ref:`VIDIOC_S_STD <VIDIOC_G_STD>` accepts one or more flags, being a write-only ioctl it 5562306a36Sopenharmony_cidoes not return the actual new standard as :ref:`VIDIOC_G_STD <VIDIOC_G_STD>` does. When 5662306a36Sopenharmony_cino flags are given or the current input does not support the requested 5762306a36Sopenharmony_cistandard the driver returns an ``EINVAL`` error code. When the standard set 5862306a36Sopenharmony_ciis ambiguous drivers may return ``EINVAL`` or choose any of the requested 5962306a36Sopenharmony_cistandards. If the current input or output does not support standard 6062306a36Sopenharmony_civideo timings (e.g. if :ref:`VIDIOC_ENUMINPUT` 6162306a36Sopenharmony_cidoes not set the ``V4L2_IN_CAP_STD`` flag), then ``ENODATA`` error code is 6262306a36Sopenharmony_cireturned. 6362306a36Sopenharmony_ci 6462306a36Sopenharmony_ciCalling ``VIDIOC_SUBDEV_S_STD`` on a subdev device node that has been registered 6562306a36Sopenharmony_ciin read-only mode is not allowed. An error is returned and the errno variable is 6662306a36Sopenharmony_ciset to ``-EPERM``. 6762306a36Sopenharmony_ci 6862306a36Sopenharmony_ciReturn Value 6962306a36Sopenharmony_ci============ 7062306a36Sopenharmony_ci 7162306a36Sopenharmony_ciOn success 0 is returned, on error -1 and the ``errno`` variable is set 7262306a36Sopenharmony_ciappropriately. The generic error codes are described at the 7362306a36Sopenharmony_ci:ref:`Generic Error Codes <gen-errors>` chapter. 7462306a36Sopenharmony_ci 7562306a36Sopenharmony_ciEINVAL 7662306a36Sopenharmony_ci The :ref:`VIDIOC_S_STD <VIDIOC_G_STD>` parameter was unsuitable. 7762306a36Sopenharmony_ci 7862306a36Sopenharmony_ciENODATA 7962306a36Sopenharmony_ci Standard video timings are not supported for this input or output. 8062306a36Sopenharmony_ci 8162306a36Sopenharmony_ciEPERM 8262306a36Sopenharmony_ci ``VIDIOC_SUBDEV_S_STD`` has been called on a read-only subdevice. 83