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