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

Создает дескриптор для экземпляра узла топологии.

Поддерживается начиная с Windows 8.

Синтаксис

KSDDKAPI HRESULT KsCreateTopologyNode2(
  [in]  HANDLE         ParentHandle,
  [in]  PKSNODE_CREATE NodeCreate,
  [in]  ACCESS_MASK    DesiredAccess,
  [out] PHANDLE        NodeHandle
);

Параметры

[in] ParentHandle

Указывает дескриптор родительского элемента, на котором создается узел.

[in] NodeCreate

Структура KSNODE_CREATE , описывающая набор сведений, используемых для создания дескриптора узла топологии.

[in] DesiredAccess

Задает ACCESS_MASK , указывающий требуемый доступ к объекту . Обычно это GENERIC_READ и (или ) GENERIC_WRITE.

[out] NodeHandle

Расположение дескриптора узла топологии.

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

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

Комментарии

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

Требования

Требование Значение
Минимальная версия клиента Windows 8
Минимальная версия сервера Windows Server 2012
Целевая платформа Универсальное
Верхняя часть ks.h (включая Ks.h)
IRQL PASSIVE_LEVEL

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

ACCESS_MASK

CoInitialize

KSNODE_CREATE

KsCreateTopologyNode