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

指向 struct v4l2_audio 的指標。

7.11.4. 描述

要查詢音訊輸入的屬性，應用程式初始化 index 欄位並清零 struct v4l2_audio 的 reserved 陣列，並呼叫 ioctl VIDIOC_ENUMAUDIO ioctl，並將指標指向該結構。 當索引超出範圍時，驅動程式會填充結構的其餘部分或返回 EINVAL 錯誤程式碼。 要列舉所有音訊輸入，應用程式應從索引零開始，每次遞增一，直到驅動程式返回 EINVAL。

有關 struct v4l2_audio 的描述，請參見 VIDIOC_G_AUDIO。

7.11.5. 返回值

成功時返回 0，出錯時返回 -1，並適當設定 errno 變數。 泛型錯誤程式碼在 泛型錯誤程式碼 章節中進行了描述。

EINVAL

音訊輸入的數量超出範圍。