BdaCreateFilterFactory 函数 (bdasup.h)

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

另请参阅

BDA_FILTER_TEMPLATE

BdaCreateFilterFactoryEx

KSDEVICE

KSFILTERFACTORY

KSFILTER_DESCRIPTOR

KSMETHODSETID_BdaChangeSync

KSMETHODSETID_BdaDeviceConfiguration

KSPROPSETID_BdaTopology