ITopologyNode 结构
资源管理器定义的拓扑节点的接口。 一个节点包含一个或多个执行资源。
语法
struct ITopologyNode;
成员
公共方法
名称 | 描述 |
---|---|
ITopologyNode::GetExecutionResourceCount | 返回在此节点下组合在一起的执行资源的数量。 |
ITopologyNode::GetFirstExecutionResource | 返回在此节点下以枚举顺序分组的第一个执行资源。 |
ITopologyNode::GetId | 返回此节点的资源管理器的唯一标识符。 |
ITopologyNode::GetNext | 返回一个指向枚举顺序中下一拓扑节点的接口。 |
ITopologyNode::GetNumaNode | 返回此资源管理器节点所属的 Windows 分配的 NUMA 节点号。 |
注解
此接口通常用于遍历资源管理器观察到的系统拓扑。
继承层次结构
ITopologyNode
要求
标头:concrtrm.h
命名空间: 并发
ITopologyNode::GetExecutionResourceCount 方法
返回在此节点下组合在一起的执行资源的数量。
virtual unsigned int GetExecutionResourceCount() const = 0;
返回值
在此节点下组合在一起的执行资源的数量。
ITopologyNode::GetFirstExecutionResource 方法
返回在此节点下以枚举顺序分组的第一个执行资源。
virtual ITopologyExecutionResource *GetFirstExecutionResource() const = 0;
返回值
在此节点下以枚举顺序分组的第一个执行资源。
ITopologyNode::GetId 方法
返回此节点的资源管理器的唯一标识符。
virtual unsigned int GetId() const = 0;
返回值
此节点的资源管理器的唯一标识符。
注解
并发运行时以处理器节点组的形式表示系统上的硬件线程。 节点通常派生自系统的硬件拓扑。 例如,特定套接字或特定 NUMA 节点上的所有处理器可能属于同一处理器节点。 资源管理器为这些节点分配唯一标识符,从 0
开始到(并且包含)nodeCount - 1
,其中 nodeCount
表示系统上处理器节点的总数。
可以从函数 GetProcessorNodeCount 获取节点计数。
ITopologyNode::GetNext 方法
返回一个指向枚举顺序中下一拓扑节点的接口。
virtual ITopologyNode *GetNext() const = 0;
返回值
一个指向枚举顺序中下一节点的接口。 如果系统拓扑的枚举顺序中没有更多的节点,则此方法将返回值 NULL
。
ITopologyNode::GetNumaNode 方法
返回此资源管理器节点所属的 Windows 分配的 NUMA 节点号。
virtual unsigned long GetNumaNode() const = 0;
返回值
此资源管理器节点所属的 Windows 分配的 NUMA 节点号。
注解
在属于此节点的虚拟处理器根上运行的线程代理将至少与此方法返回的 NUMA 节点的 NUMA 节点级别具有相关性。