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