7.11. ioctl VIDIOC_ENUMAUDIO

7.11.1. 名称

VIDIOC_ENUMAUDIO - 枚举音频输入

7.11.2. 概要

VIDIOC_ENUMAUDIO

int ioctl(int fd, VIDIOC_ENUMAUDIO, struct v4l2_audio *argp)

7.11.3. 参数

fd

由 open() 返回的文件描述符。

argp

指向 v4l2_audio 结构的指针。

7.11.4. 描述

要查询音频输入的属性，应用程序需要初始化 index 字段，并将 reserved 数组清零，此数组在 v4l2_audio 结构中。然后，使用指向此结构的指针调用 ioctl VIDIOC_ENUMAUDIO ioctl。当索引超出范围时，驱动程序会填充结构的其余部分或返回 EINVAL 错误代码。要枚举所有音频输入，应用程序应从索引零开始，每次递增一，直到驱动程序返回 EINVAL。

有关 v4l2_audio 结构的描述，请参阅 VIDIOC_G_AUDIO。

7.11.5. 返回值

成功时返回 0，出错时返回 -1，并适当设置 errno 变量。通用错误代码在 通用错误代码 章节中描述。

EINVAL

音频输入的编号超出范围。