5.11. request ioctl()

5.11.1. 名稱

request-ioctl - 控制請求檔案描述符

5.11.2. 概要

#include <sys/ioctl.h>

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

5.11.3. 引數

fd

由 ioctl MEDIA_IOC_REQUEST_ALLOC 返回的檔案描述符。

cmd

媒體標頭檔案 media.h 中定義的請求 ioctl 命令程式碼，例如 ioctl MEDIA_REQUEST_IOC_QUEUE。

argp

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

5.11.4. 描述

ioctl() 函式用於操作請求引數。引數 fd 必須是已開啟的檔案描述符。

ioctl cmd 程式碼指定要呼叫的請求函式。它編碼了引數是輸入、輸出還是讀/寫引數，以及引數 argp 的位元組大小。

指定請求 ioctl 命令及其引數的宏和結構定義位於 media.h 標頭檔案中。所有請求 ioctl 命令、它們各自的函式和引數在 函式參考 中有詳細說明。

5.11.5. 返回值

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

特定於命令的錯誤程式碼列在各個命令的描述中。

當接受輸出或讀/寫引數的 ioctl 呼叫失敗時，該引數保持不變。