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


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

Функция 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 для объекта этого типа. Сведения об этой структуре см. в Microsoft Windows SDK. Дополнительные сведения см. в разделе KSOBJECT_CREATE_ITEM. Если значение РАВНО NULL, дескриптор не назначается.

[in] CreateItemFlags

См. таблицу для элемента FlagsKSOBJECT_CREATE_ITEM.

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

KsFilterFactoryAddCreateItem возвращает успешное или неудачное завершение попытки добавления нового элемента создания.

Комментарии

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

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

Требования

Требование Значение
Минимальная версия клиента Доступно в операционных системах Microsoft Windows XP и более поздних версиях, а также DirectX 8.0 и более поздних версиях.
Целевая платформа Универсальное
Верхняя часть ks.h (включая Ks.h)
Библиотека Ks.lib

См. также раздел

KSOBJECT_CREATE_ITEM

KsAddObjectCreateItemToDeviceHeader

KsAddObjectCreateItemToObjectHeader

KsAllocateObjectCreateItem

KsFreeObjectCreateItem

KsQueryObjectCreateItem