BdaFilterFactoryUpdateCacheData 函数 (bdasup.h)

BdaFilterFactoryUpdateCacheData 函数更新筛选器实例的固定数据缓存。

语法

NTSTATUS BdaFilterFactoryUpdateCacheData(
  [in]           PKSFILTERFACTORY          pFilterFactory,
  [in, optional] const KSFILTER_DESCRIPTOR *pFilterDescriptor
);

参数

[in] pFilterFactory

指向要更新固定数据缓存的 KSFILTERFACTORY

[in, optional] pFilterDescriptor

指向将更新固定数据缓存的可选 KSFILTER_DESCRIPTOR。 如果 NULL,则改用 pFilterFactory 的描述符。 此参数启用动态引脚创建,即筛选器的创建调度例程完成后发生的固定创建。

返回值

返回STATUS_SUCCESS或适当的错误代码。 如果未找到与筛选器描述符中传递的类别相对应的设备接口,则返回STATUS_INVALID_PARAMETER。

言论

BDA 微型驱动程序调用 BdaFilterFactoryUpdateCacheData 函数,以更新在 pFilterDescriptor中指定的所有引脚的引脚数据缓存。 在此调用中,BDA 微型驱动程序通常传递 pFilterDescriptorBDA_FILTER_TEMPLATE 结构的成员,该结构描述 BDA 筛选器的模板拓扑,以 pFilterDescriptor。 如果 pFilterDescriptor 为 NULL ,则会更新在 pFilterFactory pFilterFactoryKSFILTER_DESCRIPTOR 成员中指定的所有引脚工厂的缓存信息。 有关固定数据缓存的信息,请参阅 DirectShow的缓存引脚信息。

KsRegisterFilterWithNoKSPins 函数提供类似的功能,但每个已注册的引脚只允许一个介质。 这可能不足以用于 BDA 微型驱动程序。

要求

要求 价值
目标平台 桌面
标头 bdasup.h (包括 Bdasup.h)
Bdasup.lib
IRQL PASSIVE_LEVEL

另请参阅

BDA_FILTER_TEMPLATE

KSFILTERFACTORY

KSFILTER_DESCRIPTOR

KsRegisterFilterWithNoKSPins