LOGICAL_PROCESSOR_RELATIONSHIP enumeration (winnt.h)

Article
03/06/2023

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)