3.2.17. ioctl DMX_QUERYBUF

3.2.17.1. 名稱

DMX_QUERYBUF - 查詢緩衝區狀態

警告

此API仍處於實驗階段

3.2.17.2. 概要

DMX_QUERYBUF

int ioctl(int fd, DMX_QUERYBUF, struct dvb_buffer *argp)

3.2.17.3. 引數

fd

open()返回的檔案描述符。

argp

指向結構體dvb_buffer的指標。

3.2.17.4. 描述

此ioctl是mmap流式I/O方法的一部分。 它可用於在透過ioctl DMX_REQBUFS ioctl分配緩衝區後隨時查詢緩衝區的狀態。

應用程式設定index欄位。有效的索引號範圍從零到使用ioctl DMX_REQBUFS(結構體dvb_requestbuffers count)分配的緩衝區數減一。

在使用指向此結構的指標呼叫ioctl DMX_QUERYBUF之後,驅動程式將返回錯誤程式碼或填充結構的其餘部分。

成功後,offset將包含緩衝區從裝置記憶體開始處的偏移量,length欄位將包含其大小,bytesused將包含緩衝區中資料(有效載荷)佔用的位元組數。

3.2.17.5. 返回值

成功時返回0,offset將包含緩衝區從裝置記憶體開始處的偏移量,length欄位將包含其大小,bytesused將包含緩衝區中資料(有效載荷)佔用的位元組數。

如果出錯,則返回-1,並適當設定errno變數。 通用錯誤程式碼在通用錯誤程式碼章節中描述。

EINVAL

index超出範圍。