ioctl VIDIOC_G_AUDOUT, VIDIOC_S_AUDOUT

&manvol;

VIDIOC_G_AUDOUT

VIDIOC_S_AUDOUT

Query or select the current audio output

    	int ioctl
    	int fd
    	int request
    	struct v4l2_audioout *argp

    	int ioctl
    	int fd
    	int request
    	const struct v4l2_audioout *argp

## Arguments

`fd`

- &fd;

`request`

- VIDIOC_G_AUDOUT, VIDIOC_S_AUDOUT

`argp`

## Description

To query the current audio output applications zero out the reserved array of a &v4l2-audioout; and call the `VIDIOC_G_AUDOUT` ioctl with a pointer to this structure. Drivers fill the rest of the structure or return an &EINVAL; when the device has no audio inputs, or none which combine with the current video output.

Audio outputs have no writable properties. Nevertheless, to select the current audio output applications can initialize the index field and reserved array (which in the future may contain writable properties) of a v4l2_audioout structure and call the `VIDIOC_S_AUDOUT` ioctl. Drivers switch to the requested output or return the &EINVAL; when the index is out of bounds. This is a write-only ioctl, it does not return the current audio output attributes as `VIDIOC_G_AUDOUT` does.

Note connectors on a TV card to loop back the received audio signal to a sound card are not audio outputs in this sense.

## struct v4l2_audioout

&cs-str;
__u32 | index | Identifies the audio output, set by the driver or application.
__u8 | name[32] | Name of the audio output, a NUL-terminated ASCII string, for example: "Line Out". This information is intended for the user, preferably the connector label on the device itself.
__u32 | capability | Audio capability flags, none defined yet. Drivers must set this field to zero.
__u32 | mode | Audio mode, none defined yet. Drivers and applications (on `VIDIOC_S_AUDOUT`) must set this field to zero.
__u32 | reserved[2] | Reserved for future extensions. Drivers and applications must set the array to zero.

&return-value;

EINVAL

- No audio outputs combine with the current video output, or the number of the selected audio output is out of bounds or it does not combine, or there are no audio outputs at all and the ioctl is not supported.

EBUSY

- I/O is in progress, the output cannot be switched.