BdaCreateFilterFactory 函数 (bdasup.h)

项目
02/22/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)
Library	Bdasup.lib
IRQL	PASSIVE_LEVEL