BdaCreateFilterFactoryEx 函数 (bdasup.h)

项目
08/07/2023

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 支持库 (BdaSup.sys) 。然后，BDA 支持库可以处理以下方法和属性调用：

每当 BDA 微型驱动程序需要指向新创建的 KSFILTERFACTORY 的指针时，它调用 BdaCreateFilterFactoryEx，而不是 BdaCreateFilterFactory 函数。 BdaCreateFilterFactory 函数也会创建筛选器工厂，但不将其返回给调用方。如果微型驱动程序必须调用 _KsEdit 函数才能编辑 KSFILTERFACTORY，BDA 微型驱动程序需要指向新创建的 KSFILTERFACTORY 的指针。

要求

要求	值
最低受支持的客户端	在 Microsoft Windows XP 和更高版本的操作系统上可用。
目标平台	桌面
标头	bdasup.h (包括 Bdasup.h)
Library	Bdasup.lib
IRQL	PASSIVE_LEVEL