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

Статья
02/07/2025

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

Поддерживается начиная с 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 (include Ks.h)
IRQL	PASSIVE_LEVEL

См. также

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