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