Edit

Share via

LOGICAL_PROCESSOR_RELATIONSHIP enumeration (winnt.h)

  • Article

Represents the relationship between the processor set identified in the corresponding SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX structure.

Syntax

typedef enum _LOGICAL_PROCESSOR_RELATIONSHIP {
  RelationProcessorCore,
  RelationNumaNode,
  RelationCache,
  RelationProcessorPackage,
  RelationGroup,
  RelationProcessorDie,
  RelationNumaNodeEx,
  RelationProcessorModule,
  RelationAll = 0xffff
} LOGICAL_PROCESSOR_RELATIONSHIP;

Constants

 
RelationProcessorCore
The specified logical processors share a single processor core.
RelationNumaNode
The specified logical processors are part of the same NUMA node.
RelationCache
The specified logical processors share a cache.

Windows Server 2003:  This value is not supported until Windows Server 2003 with SP1 and Windows XP Professional x64 Edition.
RelationProcessorPackage
The specified logical processors share a physical package (a single package socketed or soldered onto a motherboard may contain multiple processor cores or threads, each of which is treated as a separate processor by the operating system).

Windows Server 2003:  This value is not supported until Windows Server 2003 with SP1 and Windows XP Professional x64 Edition.
RelationGroup
The specified logical processors share a single processor group.

Windows Server 2008, Windows Vista, Windows Server 2003 and Windows XP Professional x64 Edition:  This value is not supported until Windows Server 2008 R2.
RelationProcessorDie
The specified logical processors share a single processor die.
RelationNumaNodeEx
Introduced in Windows Server 2022 (21H2, build 20348). Requests that the full affinity be returned. Unlike the other relation types, RelationNumaNodeEx is not used on input. It is simply a request for RelationNumaNode with full group information.
RelationAll
Value: 0xffff
On input, retrieves information about all possible relationship types. This value is not used on output.

Windows Server 2008, Windows Vista, Windows Server 2003 and Windows XP Professional x64 Edition:  This value is not supported until Windows Server 2008 R2.

Remarks

The value specified by this enumeration indicates the relationship represented in the corresponding SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX structure.

Examples

For an example, see GetLogicalProcessorInformation.

Requirements

Requirement Value
Minimum supported client Windows Vista, Windows XP Professional x64 Edition [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header winnt.h (include Windows.h)

See also

GetLogicalProcessorInformation

GetLogicalProcessorInformationEx

SYSTEM_LOGICAL_PROCESSOR_INFORMATION

SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX