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 失败时，参数保持未修改状态。