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)

另請參閱

KSFILTER_DESCRIPTOR

KSFILTER_DISPATCH

KsAddItemToObjectBag

KsCompletePendingRequest