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