2.4.4. ioctl FE_READ_STATUS

2.4.4.1. 名称

FE_READ_STATUS - 返回前端的状态信息。此调用仅需要对设备的只读访问权限

2.4.4.2. 概要

FE_READ_STATUS

int ioctl(int fd, FE_READ_STATUS, unsigned int *status)

2.4.4.3. 参数

fd

open() 返回的文件描述符。

status

指向位掩码整数的指针,该整数填充了由枚举 fe_status 定义的值。

2.4.4.4. 描述

所有数字电视前端设备都支持 FE_READ_STATUS ioctl。它用于检查前端在调谐后的锁定状态。ioctl 接受一个指向整数的指针,该状态将写入该整数。

注意

status 的大小实际上是 sizeof(enum fe_status),它会随着体系结构的变化而变化。这需要在未来修复。

2.4.4.5. int fe_status

fe_status 参数用于指示前端硬件的当前状态和/或状态变化。它使用位掩码上的枚举 fe_status 值生成。

2.4.4.6. 返回值

成功时返回 0。

发生错误时返回 -1,并且 errno 变量将设置为相应的值。

通用错误代码在 通用错误代码 章节中进行了描述。