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

Статья
02/07/2025

Функция KsFilterFactoryAddCreateItem добавляет новый элемент для указанной фабрики фильтров.

Синтаксис

KSDDKAPI NTSTATUS KsFilterFactoryAddCreateItem(
  [in]           PKSFILTERFACTORY     FilterFactory,
  [in]           PWSTR                RefString,
  [in, optional] PSECURITY_DESCRIPTOR SecurityDescriptor,
  [in]           ULONG                CreateItemFlags
);

Параметры

[in] FilterFactory

Указатель на структуру KSFILTERFACTORY, представляющую фабрику фильтров, в которую необходимо добавить новый элемент.

[in] RefString

Указатель на текстовую строку Юникода, которая идентифицирует элемент создания.

[in, optional] SecurityDescriptor

Этот параметр при необходимости содержит указатель на структуру SECURITY_DESCRIPTOR для этого типа объекта. Дополнительные сведения об этой структуре см. в пакете SDK для Microsoft Windows. Дополнительные сведения см. в KSOBJECT_CREATE_ITEM. Если значение NULL, дескриптор не назначается.

[in] CreateItemFlags

См. таблицу для KSOBJECT_CREATE_ITEMэлемента флагов.

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

KsFilterFactoryAddCreateItem возвращает успех или сбой попытки добавить новый элемент.

Замечания

Как правило, для фабрики фильтров добавляется только один элемент создания с помощью ссылочного GUID, предоставленного в дескрипторе фильтра. Эта функция позволяет вызывающему объекту добавлять элементы, связанные с данной фабрикой фильтров.

Дополнительные сведения см. в разделе Инициализация мини-AVStream Minidriver.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Microsoft Windows XP и более поздних операционных системах и версиях DirectX 8.0 и более поздних версий DirectX.
целевая платформа	Всеобщий
заголовка	ks.h (include Ks.h)
библиотеки	Ks.lib