Функция KsFilterFactoryUpdateCacheData (ks.h)
Функция KsFilterFactoryUpdateCacheData обновляет раздел реестра FilterData и средний кэш (набор разделов реестра) для заданной фабрики фильтров.
Синтаксис
KSDDKAPI NTSTATUS KsFilterFactoryUpdateCacheData(
[in] PKSFILTERFACTORY FilterFactory,
[in, optional] const KSFILTER_DESCRIPTOR *FilterDescriptor
);
Параметры
[in] FilterFactory
KSFILTERFACTORY, для которого необходимо обновить кэш FilterData и Medium в реестре.
[in, optional] FilterDescriptor
Необязательный KSFILTER_DESCRIPTOR, для которого будет обновлен ключ FilterData и средний кэш. Если значение NULL, вместо него используется дескриптор FilterFactory . Укажите, используется ли фабрика фильтров динамические пин-коды и требуется обновить сведения о пин-кодах, которые еще не созданы.
Возвращаемое значение
KsFilterFactoryUpdateCacheData возвращает STATUS_SUCCESS или код сбоя, указывающий, успешно ли обновлена соответствующая информация реестра. Он возвращает STATUS_INVALID_PARAMETER, если интерфейс устройства не найден, соответствующий категориям, переданным в дескрипторе фильтра.
Замечания
Эта функция обновляет ключ FilterData и кэш medium для всех категорий, указанных в FilterDescriptor. Если FilterDescriptorNULL, кэш FilterData и Medium обновляются для всех категорий, указанных в элементе FilterFactoryKSFILTER_DESCRIPTOR.
KsRegisterFilterWithNoKSPins предоставляет аналогичные функциональные возможности, но не следует использовать, если два экземпляра KSFILTER_DESCRIPTOR в одной KSDEVICE регистрируются в одной категории и отличаются только в ссылочных GUID. В этом случае KsRegisterFilterWithNoKSPins обновлять данные только для первых, даже если второй может быть указан.
Не используйте эту подпрограмму вместо KsRegisterFilterWithNoKSPins для фильтров без пин-адресов KS, таких как перекрестные перекрестные панели стиля аналогового стиля. Используйте эту подпрограмму только для определенного фильтра, для которого мини-driver передает соответствующую фабрику фильтров.
Кроме того, KsRegisterFilterWithNoKSPins допускает только один носитель на зарегистрированный пин-код. Это может быть недостаточно для мини-driver BDA.
Дополнительные сведения см. в иерархии объектов AVStream.
Функция KsFilterFactoryUpdateCacheData может вызываться только в PASSIVE_LEVEL.
Требования
Требование | Ценность |
---|---|
целевая платформа | Всеобщий |
заголовка | ks.h (include Ks.h) |
библиотеки | Ks.lib |