Edit

ITopologyNode Structure

  • Article

An interface to a topology node as defined by the Resource Manager. A node contains one or more execution resources.

Syntax

struct ITopologyNode;

Members

Public Methods

Name Description
ITopologyNode::GetExecutionResourceCount Returns the number of execution resources grouped together under this node.
ITopologyNode::GetFirstExecutionResource Returns the first execution resource grouped under this node in enumeration order.
ITopologyNode::GetId Returns the Resource Manager's unique identifier for this node.
ITopologyNode::GetNext Returns an interface to the next topology node in enumeration order.
ITopologyNode::GetNumaNode Returns the Windows assigned NUMA node number to which this Resource Maanger node belongs.

Remarks

This interface is typically utilized to walk the topology of the system as observed by the Resource Manager.

Inheritance Hierarchy

ITopologyNode

Requirements

Header: concrtrm.h

Namespace: concurrency

ITopologyNode::GetExecutionResourceCount Method

Returns the number of execution resources grouped together under this node.

virtual unsigned int GetExecutionResourceCount() const = 0;

Return Value

The number of execution resources grouped together under this node.

ITopologyNode::GetFirstExecutionResource Method

Returns the first execution resource grouped under this node in enumeration order.

virtual ITopologyExecutionResource *GetFirstExecutionResource() const = 0;

Return Value

The first execution resource grouped under this node in enumeration order.

ITopologyNode::GetId Method

Returns the Resource Manager's unique identifier for this node.

virtual unsigned int GetId() const = 0;

Return Value

The Resource Manager's unique identifier for this node.

Remarks

The Concurrency Runtime represents hardware threads on the system in groups of processor nodes. Nodes are usually derived from the hardware topology of the system. For example, all processors on a specific socket or a specific NUMA node may belong to the same processor node. The Resource Manager assigns unique identifiers to these nodes starting with 0 up to and including nodeCount - 1, where nodeCount represents the total number of processor nodes on the system.

The count of nodes can be obtained from the function GetProcessorNodeCount.

ITopologyNode::GetNext Method

Returns an interface to the next topology node in enumeration order.

virtual ITopologyNode *GetNext() const = 0;

Return Value

An interface to the next node in enumeration order. If there are no more nodes in enumeration order of the system topology, this method will return the value NULL.

ITopologyNode::GetNumaNode Method

Returns the Windows assigned NUMA node number to which this Resource Maanger node belongs.

virtual unsigned long GetNumaNode() const = 0;

Return Value

The Windows assigned NUMA node number to which this Resource Manager node belongs.

Remarks

A thread proxy running on a virtual processor root belonging to this node will have affinity to at least the NUMA node level for the NUMA node returned by this method.

See also

concurrency Namespace