vidioc-g-input.rst 1.7 KB
Newer Older
1 2
.. -*- coding: utf-8; mode: rst -*-

3
.. _VIDIOC_G_INPUT:
4 5 6 7 8

************************************
ioctl VIDIOC_G_INPUT, VIDIOC_S_INPUT
************************************

9
Name
10
====
11

12
VIDIOC_G_INPUT - VIDIOC_S_INPUT - Query or select the current video input
13

14 15

Synopsis
16 17
========

18 19 20 21 22
.. c:function:: int ioctl( int fd, VIDIOC_G_INPUT, int *argp )
    :name: VIDIOC_G_INPUT

.. c:function:: int ioctl( int fd, VIDIOC_S_INPUT, int *argp )
    :name: VIDIOC_S_INPUT
23

24

25
Arguments
26 27 28 29 30 31 32 33
=========

``fd``
    File descriptor returned by :ref:`open() <func-open>`.

``argp``


34
Description
35 36 37
===========

To query the current video input applications call the
38
:ref:`VIDIOC_G_INPUT <VIDIOC_G_INPUT>` ioctl with a pointer to an integer where the driver
39
stores the number of the input, as in the struct
40
:c:type:`v4l2_input` ``index`` field. This ioctl will fail
41
only when there are no video inputs, returning ``EINVAL``.
42 43

To select a video input applications store the number of the desired
44
input in an integer and call the :ref:`VIDIOC_S_INPUT <VIDIOC_G_INPUT>` ioctl with a pointer
45 46 47 48 49 50 51
to this integer. Side effects are possible. For example inputs may
support different video standards, so the driver may implicitly switch
the current standard. Because of these possible side effects
applications must select an input before querying or negotiating any
other parameters.

Information about video inputs is available using the
52
:ref:`VIDIOC_ENUMINPUT` ioctl.
53 54


55
Return Value
56 57 58 59 60 61 62 63
============

On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter.

EINVAL
    The number of the video input is out of bounds.
新手
引导
客服 返回
顶部