Функция BdaFilterFactoryUpdateCacheData (bdasup.h)
Функция BdaFilterFactoryUpdateCacheData обновляет кэш данных пин-кода для экземпляра фильтра.
Синтаксис
NTSTATUS BdaFilterFactoryUpdateCacheData(
[in] PKSFILTERFACTORY pFilterFactory,
[in, optional] const KSFILTER_DESCRIPTOR *pFilterDescriptor
);
Параметры
[in] pFilterFactory
Указывает на KSFILTERFACTORY, для которого необходимо обновить кэш пин-данных.
[in, optional] pFilterDescriptor
Указывает на необязательный KSFILTER_DESCRIPTOR, для которого будет обновлен кэш пин-данных. Если значение NULL, вместо этого используется дескриптор pFilterFactorypFilterFactory. Этот параметр включает динамическое создание пин-кода, то есть создание пин-кода, которое происходит после завершения процедуры создания диспетчеризации фильтра.
Возвращаемое значение
Возвращает STATUS_SUCCESS или соответствующий код ошибки. Возвращает STATUS_INVALID_PARAMETER, если интерфейс устройства не найден, соответствующий категориям, переданным в дескрипторе фильтра.
Замечания
Мини-driver BDA вызывает функцию BdaFilterFactoryUpdateCacheData для обновления кэша данных пин-кода для всех контактов, указанных в pFilterDescriptor. В этом вызове мини-driver BDA обычно передает элемент pFilterDescriptor элемент структуры BDA_FILTER_TEMPLATE, описывающий топологию шаблона фильтра BDA, чтобы pFilterDescriptor. Если pFilterDescriptorNULL, кэшированные сведения будут обновлены для всех фабрик закреплений, указанных в pFilterFactoryчлена KSFILTER_DESCRIPTOR. Сведения о кэше пин-данных см. в разделе Кэширование сведений о закреплении пин-кода для DirectShow.
Функция KsRegisterFilterWithNoKSPins предоставляет аналогичную функциональность, но позволяет только один носитель на зарегистрированный пин-код. Это может быть недостаточно для мини-driver BDA.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | bdasup.h (include Bdasup.h) |
| библиотеки | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |