KSFILTER 結構 (ks.h)
KSFILTER 結構描述具現化篩選條件。
語法
typedef struct _KSFILTER {
const KSFILTER_DESCRIPTOR *Descriptor;
KSOBJECT_BAG Bag;
PVOID Context;
} KSFILTER, *PKSFILTER;
成員
Descriptor
描述此特定篩選特性 之KSFILTER_DESCRIPTOR 結構的指標。
Bag
此成員指定與這個篩選實例相關聯的KSOBJECT_BAG (，相當於類型 PVOID) 。 物件包 是用來將動態記憶體與特定AVStream物件建立關聯的結構。 篩選物件包中的任何專案會在刪除篩選時自動清除。
Context
用戶端用來將內容資訊與特定篩選實例產生關聯的指標。 一般而言，這類內容資訊會與篩選的 Create 成員相關聯，如此篩選實例的KSFILTER_DISPATCH數據表中所定義。 任何動態配置的內容信息都應該放在具有 KsAddItemToObjectBag 的物件包中。 內容會在建立篩選時初始化為父 KSFILTERFACTORY 之 Context 成員的值。 請參閱 AVStream物件階層。
備註
實作軟體篩選的驅動程式通常會將篩選狀態與 KSFILTER 結構產生關聯。 軟體篩選通常會在對應KSFILTER_DISPATCH結構之 Process 成員所指定的回呼內處理數據。
硬體篩選通常不會使用 KSFILTER，因為硬體驅動程式的焦點是平台轉換：主機與外部硬體之間的數據移動。 此轉換通常是由與AVStream佇列對象相關聯的程式代碼來處理。
另請參閱 物件包。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Microsoft Windows XP 和更新版本的作業系統和 Microsoft DirectX 8.0 和更新版本中取得。 |
| 標頭 | ks.h (包含 Ks.h) |