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 |