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 類型）。 Object Bags 是用來將易失記憶體與特定 AVStream 物件產生關聯的結構。 篩選物件包中的任何項目都會在刪除篩選時自動清除。
Context
用戶端用來將內容資訊與特定篩選實例產生關聯的指標。 一般而言，這類內容資訊會在篩選 建立 成員中相關聯，如此篩選實例的 KSFILTER_DISPATCH 數據表中所定義。 任何動態配置的內容資訊都應該放在物件包中，KsAddItemToObjectBag。 Context 會在建立篩選時初始化為父 KSFILTERFACTORY 之 Context 成員的值。 請參閱 AVStream 物件階層。
言論
實作軟體篩選的驅動程式通常會將篩選狀態與 KSFILTER 結構產生關聯。 軟體篩選通常會在對應 KSFILTER_DISPATCH 結構之 進程 成員所指定的回呼內處理數據。
硬體篩選器通常不會使用 KSFILTER，因為硬體驅動程式的焦點是平台轉換：主機與外部硬體之間的數據移動。 此轉換通常是由與AVStream佇列對象相關聯的程式代碼來處理。
請參閱 物件包。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 適用於 Microsoft Windows XP 和更新版本的作系統，以及 Microsoft DirectX 8.0 和更新版本。 |
| 標頭 | ks.h （包括 Ks.h） |