bdaCreateFilterFactory 函式 (bdasup.h)

發行項
02/25/2024

BdaCreateFilterFactory 函式會將指定的篩選描述元新增為篩選處理站至指定的裝置，並將篩選處理站與指定的 BDA 範本拓撲產生關聯。

語法

NTSTATUS BdaCreateFilterFactory(
  [in] PKSDEVICE                 pKSDevice,
  [in] const KSFILTER_DESCRIPTOR *pFilterDescriptor,
  [in] const BDA_FILTER_TEMPLATE *pBdaFilterTemplate
);

參數

[in] pKSDevice

指向要新增具有相關聯 BDA 範本拓撲之篩選處理站的 BDA 裝置。

[in] pFilterDescriptor

指向描述 BDA 裝置篩選的 KSFILTER_DESCRIPTOR 結構。請注意，當第一次初始化篩選時，並非所有範本釘選和節點類型都可以公開為針腳和節點處理站。

[in] pBdaFilterTemplate

指向描述 BDA 範本拓撲的BDA_FILTER_TEMPLATE 結構。

傳回值

傳回STATUS_SUCCESS或適當的錯誤碼。

備註

BDA 迷你驅動程式會呼叫 BdaCreateFilterFactory 函式，將具有相關聯 BDA 範本拓撲的篩選處理站新增至裝置，並使用 BDA 支援連結庫註冊所有拓撲的靜態範本結構 ， (BdaSup.sys) 。然後，BDA 支援連結庫可以處理下列方法和屬性呼叫：

如果 BDA 迷你驅動程式需要新建立的篩選處理站指標， (KSFILTERFACTORY) ，迷你驅動程式應該改為呼叫 BdaCreateFilterFactoryEx 函式。

規格需求

需求	值
最低支援的用戶端	可在 Microsoft Windows XP 和更新版本的作業系統上使用。
目標平台	桌面
標頭	bdasup.h (包含 Bdasup.h)
程式庫	Bdasup.lib
IRQL	PASSIVE_LEVEL