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 支持库 (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 |