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 及更高版本的作系统上可用。 仅当 Microsoft DirectX 9.0 及更高版本安装在该平台上时,Windows 2000 平台上才提供此例程。
目标平台 桌面
标头 bdasup.h (包括 Bdasup.h)
Bdasup.lib
IRQL PASSIVE_LEVEL

另请参阅

BDA_FILTER_TEMPLATE

BdaCreateFilterFactory

BdaCreatePin

KSFILTER