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 |