Функция BdaFilterFactoryUpdateCacheData (bdasup.h)

Статья
02/22/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 обычно передает элемент pFilterDescriptorструктуры BDA_FILTER_TEMPLATE , которая описывает топологию шаблона для фильтра BDA в pFilterDescriptor. Если параметр pFilterDescriptor имеет значение NULL, кэшированные сведения будут обновлены для всех фабрик контактов, указанных в элементе KSFILTER_DESCRIPTOR pFilterFactory. Сведения о кэше данных контактов см. в разделе Кэширование сведений о пин-коде для DirectShow.

Функция KsRegisterFilterWithNoKSPins предоставляет аналогичные функции, но позволяет использовать только один носитель для каждого зарегистрированного контакта. Этого может быть недостаточно для мини-драйвера BDA.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	bdasup.h (включая Bdasup.h)
Библиотека	Bdasup.lib
IRQL	PASSIVE_LEVEL

См. также раздел

BDA_FILTER_TEMPLATE

KSFILTERFACTORY

KSFILTER_DESCRIPTOR

KsRegisterFilterWithNoKSPins

Share via