BdaInitFilter 函数 (bdasup.h)
BdaInitFilter 函数初始化与筛选器实例关联的 BDA 筛选器上下文。
语法
NTSTATUS BdaInitFilter(
[in] PKSFILTER pKSFilter,
[in] const BDA_FILTER_TEMPLATE *pBdaFilterTemplate
);
参数
[in] pKSFilter
指向要在其中初始化 BDA 筛选器上下文的筛选器。
[in] pBdaFilterTemplate
指向描述 BDA 设备的筛选器模板的 BDA_FILTER_TEMPLATE 结构。 为了确定其拓扑并配置初始化的筛选器，网络提供程序使用此BDA_FILTER_TEMPLATE结构中引用的信息。
返回值
返回STATUS_SUCCESS或相应的错误代码。
注解
BDA 微型驱动程序调用 BdaInitFilter 函数，以使用特定的 BDA 筛选器模板和以前通过调用 BdaCreateFilterFactory 函数创建的筛选器工厂初始化筛选器的实例。 BDA 微型驱动程序随后可以在调用其他 BDA 支持函数（如 BdaCreatePin）时使用此筛选器实例。
当 BDA 微型驱动程序调用 BdaInitFilter 时，BDA 支持驱动程序 (Bdasup.sys) 创建自己的 BDA 筛选器上下文。 此 BDA 筛选器上下文对 BDA 微型驱动程序隐藏。 但是，如果需要，BDA 支持驱动程序可以访问此 BDA 筛选器上下文。 BDA 支持驱动程序将指向此 BDA 筛选器上下文的指针添加到关联的 KSFILTER 对象的对象包。 销毁关联的 KSFILTER 对象时，AVStream 请求 BDA 支持驱动程序从对象包中删除此 BDA 筛选器上下文。 这样，BDA 支持驱动程序可以销毁此 BDA 筛选器上下文，而无需 BDA 微型驱动程序的干预。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 适用于 Microsoft Windows XP 及更高版本的操作系统。 只有在 Windows 2000 平台上安装了 Microsoft DirectX 9.0 及更高版本时，此例程才在 Windows 2000 平台上可用。 |
| 目标平台 | 桌面 |
| 标头 | bdasup.h (包括 Bdasup.h) |
| Library | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |