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

另请参阅

BDA_FILTER_TEMPLATE

BdaCreateFilterFactory

BdaCreatePin

KSFILTER