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 调用失败时，该参数保持不变。