Функция KsFilterFactoryUpdateCacheData (ks.h)

Статья
02/26/2024

Функция KsFilterFactoryUpdateCacheData обновляет раздел реестра FilterData и кэш Medium (набор разделов реестра) для заданной фабрики фильтров.

Синтаксис

KSDDKAPI NTSTATUS KsFilterFactoryUpdateCacheData(
  [in]           PKSFILTERFACTORY          FilterFactory,
  [in, optional] const KSFILTER_DESCRIPTOR *FilterDescriptor
);

Параметры

[in] FilterFactory

KSFILTERFACTORY, для которого требуется обновить FilterData и средний кэш в реестре.

[in, optional] FilterDescriptor

Необязательный KSFILTER_DESCRIPTOR , для которого будут обновлены ключ FilterData и кэш Medium. Если значение NULL, вместо него используется дескриптор FilterFactory. Укажите, использует ли фабрика фильтров динамические контакты и требуется обновить сведения о контактах, экземпляр которых еще не создан.

Возвращаемое значение

KsFilterFactoryUpdateCacheData возвращает STATUS_SUCCESS или код сбоя, указывающий, были ли успешно обновлены соответствующие сведения реестра. Он возвращает STATUS_INVALID_PARAMETER, если интерфейс устройства не найден, соответствующий категориям, переданным в дескрипторе фильтра.

Эта функция обновляет ключ FilterData и кэш medium для всех категорий, указанных в FilterDescriptor. Если параметр FilterDescriptor имеет значение NULL, кэш FilterData и Medium обновляются для всех категорий, указанных в элементе KSFILTER_DESCRIPTORFilterFactory.

KsRegisterFilterWithNoKSPins предоставляет аналогичные функциональные возможности, но не следует использовать, если два экземпляра KSFILTER_DESCRIPTOR в одной и той же категории зарегистрированы в одной категории и отличаются только идентификатором GUID ссылки. В этом случае KsRegisterFilterWithNoKSPins обновляет данные только для первого, даже если был указан второй.

Не используйте эту подпрограмму вместо KsRegisterFilterWithNoKSPins для фильтров без контактов KS, таких как перекладины аналогового стиля. Используйте эту подпрограмму только для определенного фильтра, для которого мини-диск передает соответствующую фабрику фильтров.

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

Дополнительные сведения см. в разделе Иерархия объектов AVStream.

Функцию KsFilterFactoryUpdateCacheData можно вызывать только в PASSIVE_LEVEL.