5.13. ioctl MEDIA_REQUEST_IOC_QUEUE¶

5.13.1. 名称¶

MEDIA_REQUEST_IOC_QUEUE - 将请求入队

int ioctl(int request_fd, MEDIA_REQUEST_IOC_QUEUE)

如果媒体设备支持请求，则可以使用此请求 ioctl 来排队先前分配的请求。

如果请求已成功排队，则可以轮询文件描述符，以等待请求完成。

如果该请求之前已排队，则返回 EBUSY。如果请求的内容包含无效或不一致的数据，则可能会返回其他错误，请参阅下一节以获取常见错误代码的列表。发生错误时，请求和驱动程序状态均保持不变。

一旦请求被排队，驱动程序必须优雅地处理在请求应用于硬件时发生的错误。例外情况是 EIO 错误，它表示一个致命错误，需要应用程序停止流式传输以重置硬件状态。

不允许将排队请求与直接排队缓冲区（没有请求）混合使用。如果第一个缓冲区直接排队，而您接下来尝试排队请求，反之亦然，则将返回 EBUSY。

一个请求必须包含至少一个缓冲区，否则此 ioctl 将返回一个 ENOENT 错误。

成功时返回 0，失败时返回 -1，并且会适当地设置 errno 变量。通用错误代码在通用错误代码章节中描述。