5.3. media ioctl()

5.3.1. 名稱

media-ioctl - 控制媒體裝置

5.3.2. 概要

#include <sys/ioctl.h>

int ioctl(int fd, int request, void *argp)

5.3.3. 引數

fd

由 open() 返回的檔案描述符。

request

媒體 ioctl 請求程式碼，如 media.h 標頭檔案中所定義，例如 MEDIA_IOC_SETUP_LINK。

argp

指向特定於請求的結構的指標。

5.3.4. 描述

ioctl() 函式操作媒體裝置引數。引數 fd 必須是一個開啟的檔案描述符。

ioctl request 程式碼指定要呼叫的媒體功能。它在其中編碼了引數是輸入、輸出還是讀/寫引數，以及引數 argp 的大小（以位元組為單位）。

指定媒體 ioctl 請求及其引數的宏和結構定義位於 media.h 標頭檔案中。 所有媒體 ioctl 請求、它們的各自功能和引數都在 功能參考 中指定。

5.3.5. 返回值

成功時返回 0，出錯時返回 -1 並且適當地設定 errno 變數。 通用錯誤程式碼在 通用錯誤程式碼 章節中描述。

特定於請求的錯誤程式碼在各個請求描述中列出。

當採用輸出或讀/寫引數的 ioctl 失敗時，引數保持未修改狀態。