共用方式為


bdaCreateFilterFactoryEx 函式 (bdasup.h)

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

語法

NTSTATUS BdaCreateFilterFactoryEx(
  [in]            PKSDEVICE                 pKSDevice,
  [in]            const KSFILTER_DESCRIPTOR *pFilterDescriptor,
  [in]            const BDA_FILTER_TEMPLATE *pBdaFilterTemplate,
  [out, optional] PKSFILTERFACTORY          *ppKSFilterFactory
);

參數

[in] pKSDevice

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

[in] pFilterDescriptor

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

[in] pBdaFilterTemplate

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

[out, optional] ppKSFilterFactory

指向緩衝區,該緩衝區會接收新建立之篩選處理站 之 KSFILTERFACTORY 結構的指標。

傳回值

傳回STATUS_SUCCESS或適當的錯誤碼。

備註

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

每當需要新建立 KSFILTERFACTORY 的指標時,BDA Minidriver 會呼叫 BdaCreateFilterFactoryEx, 而不是 BdaCreateFilterFactory 函式。 BdaCreateFilterFactory 函式也會建立篩選處理站,但不會將它傳回給呼叫端。 如果迷你驅動程式必須呼叫 _KsEdit 函式來編輯 KSFILTERFACTORY,BDA 迷你驅動程式需要新建立 KSFILTERFACTORY 的指標。

規格需求

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

另請參閱

BDA_FILTER_TEMPLATE

BdaCreateFilterFactory

KSDEVICE

KSFILTERFACTORY

KSFILTER_DESCRIPTOR

KSMETHODSETID_BdaChangeSync

KSMETHODSETID_BdaDeviceConfiguration

KSPROPSETID_BdaTopology

_KsEdit