Поделиться через


Функция 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

См. также

KSFILTERFACTORY

KSFILTER_DESCRIPTOR

KsRegisterFilterWithNoKSPins