Функция 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 обычно передает элемент pFilterDescriptorструктуры BDA_FILTER_TEMPLATE , которая описывает топологию шаблона для фильтра BDA в pFilterDescriptor. Если параметр pFilterDescriptor имеет значение NULL, кэшированные сведения будут обновлены для всех фабрик контактов, указанных в элементе KSFILTER_DESCRIPTOR pFilterFactory. Сведения о кэше данных контактов см. в разделе Кэширование сведений о пин-коде для DirectShow.
Функция KsRegisterFilterWithNoKSPins предоставляет аналогичные функции, но позволяет использовать только один носитель для каждого зарегистрированного контакта. Этого может быть недостаточно для мини-драйвера BDA.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | bdasup.h (включая Bdasup.h) |
| Библиотека | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |