3.2.9. DMX_SET_FILTER

3.2.9.1. 名稱

DMX_SET_FILTER

3.2.9.2. 概要

DMX_SET_FILTER

int ioctl(int fd, DMX_SET_FILTER, struct dmx_sct_filter_params *params)

3.2.9.3. 引數

fd

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

params

指向包含過濾器引數的結構的指標。

3.2.9.4. 描述

此 ioctl 呼叫根據提供的過濾器和掩碼引數設定過濾器。可以定義一個超時時間，用於說明等待載入 section 的秒數。值為 0 表示不應應用超時。最後，有一個標誌欄位，可以在其中說明是否應檢查 section 的 CRC、過濾器是否應為“一次性”過濾器，即在收到第一個 section 後是否應停止過濾操作，以及是否應立即啟動過濾操作（無需等待 DMX_START ioctl 呼叫）。如果先前設定了過濾器，則將取消此過濾器，並且接收緩衝區將被重新整理。

3.2.9.5. 返回值

成功時返回 0。

出錯時返回 -1，並且會適當地設定 errno 變數。

通用錯誤程式碼在 通用錯誤程式碼 章節中描述。