Функция 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 |
См. также раздел
KsAddObjectCreateItemToDeviceHeader