BdaFilterFactoryUpdateCacheData 函数 (bdasup.h)

项目
02/26/2024

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 微型驱动程序通常会将描述 BDA 筛选器模板拓扑的BDA_FILTER_TEMPLATE结构的 pFilterDescriptor 成员传递给 pFilterDescriptor。如果 pFilterDescriptor 为 NULL，将为 pFilterFactory 的 KSFILTER_DESCRIPTOR 成员中指定的所有引脚工厂更新缓存的信息。有关固定数据缓存的信息，请参阅为 DirectShow 缓存固定信息。

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