SYSTEM_LOGICAL_PROCESSOR_INFORMATION-Struktur (winnt.h)

  • Artikel

Beschreibt die Beziehung zwischen dem angegebenen Prozessorsatz. Diese Struktur wird mit der GetLogicalProcessorInformation-Funktion verwendet.

Syntax

typedef struct _SYSTEM_LOGICAL_PROCESSOR_INFORMATION {
  ULONG_PTR                      ProcessorMask;
  LOGICAL_PROCESSOR_RELATIONSHIP Relationship;
  union {
    struct {
      BYTE Flags;
    } ProcessorCore;
    struct {
      DWORD NodeNumber;
    } NumaNode;
    CACHE_DESCRIPTOR Cache;
    ULONGLONG        Reserved[2];
  } DUMMYUNIONNAME;
} SYSTEM_LOGICAL_PROCESSOR_INFORMATION, *PSYSTEM_LOGICAL_PROCESSOR_INFORMATION;

Member

ProcessorMask

Die Prozessormaske, die die durch diese Struktur beschriebenen Prozessoren identifiziert. Eine Prozessormaske ist ein Bitvektor, in dem jedes festgelegte Bit einen aktiven Prozessor in der Beziehung darstellt. Es wird mindestens ein Bit festgelegt.

Auf einem System mit mehr als 64 Prozessoren identifiziert die Prozessormaske Prozessoren in einer einzelnen Prozessorgruppe.

Relationship

Die Beziehung zwischen den Prozessoren, die durch den Wert des ProcessorMask-Members identifiziert werden. Dieser Member kann einer der folgenden LOGICAL_PROCESSOR_RELATIONSHIP Werte sein.

Wert Bedeutung
RelationCache
2
 Die angegebenen logischen Prozessoren teilen sich einen Cache. Das Cacheelement enthält zusätzliche Informationen.

Windows Server 2003: Dieser Wert wird erst unter Windows Server 2003 mit SP1 und Windows XP Professional x64 Edition unterstützt.
RelationNumaNode
1
 Die angegebenen logischen Prozessoren sind Teil desselben NUMA-Knotens. Das NumaNode-Element enthält zusätzliche Informationen.
RelationProcessorCore
0
 Die angegebenen logischen Prozessoren teilen sich einen einzelnen Prozessorkern. Das ProcessorCore-Element enthält zusätzliche Informationen.
RelationProcessorPackage
3
 Die angegebenen logischen Prozessoren nutzen ein physisches Paket. Es sind keine zusätzlichen Informationen verfügbar.

Windows Server 2003 und Windows XP Professional x64 Edition: Dieser Wert wird erst unter Windows Server 2003 mit SP1 und Windows XP mit SP3 unterstützt.
 

Zukünftige Versionen von Windows unterstützen möglicherweise zusätzliche Werte für das Beziehungselement .

DUMMYUNIONNAME

DUMMYUNIONNAME.ProcessorCore

Diese Struktur enthält nur gültige Daten, wenn das Beziehungselement RelationProcessorCore ist.

DUMMYUNIONNAME.ProcessorCore.Flags

Wenn der Wert dieses Members 1 ist, teilen die logischen Prozessoren, die durch den Wert des ProcessorMask-Members identifiziert werden, Funktionseinheiten, wie in Hyperthreading oder SMT. Andernfalls teilen sich die identifizierten logischen Prozessoren keine Funktionseinheiten.

Windows Server 2003 und Windows XP Professional x64 Edition: Dieser Member ist auch 1 für Kerne, die ein physisches Paket gemeinsam nutzen. Verwenden Sie daher die CPUID-Anweisung, um zu bestimmen, ob der Prozessor mehrere Kerne oder Hyperthreading auf Systemen vor Windows Vista unterstützt.

DUMMYUNIONNAME.NumaNode

Diese Struktur enthält nur gültige Daten, wenn das Beziehungselement RelationNumaNode ist.

DUMMYUNIONNAME.NumaNode.NodeNumber

Identifiziert den NUMA-Knoten . Die gültigen Werte dieses Parameters sind 0 bis zur höchsten NUMA-Knotennummer einschließlich. Ein Nicht-NUMA-Multiprozessorsystem meldet, dass alle Prozessoren zu einem NUMA-Knoten gehören.

DUMMYUNIONNAME.Cache

Eine CACHE_DESCRIPTOR-Struktur , die die Merkmale eines bestimmten Caches identifiziert. Für jeden gemeldeten Cache wird ein Datensatz zurückgegeben. Einige oder alle Caches werden möglicherweise nicht gemeldet, abhängig vom Mechanismus, der vom Prozessor zur Identifizierung seiner Caches verwendet wird. Gehen Sie daher nicht davon aus, dass bestimmte Caches fehlen. Caches werden nicht unbedingt von logischen Prozessoren gemeinsam genutzt.

Diese Struktur enthält nur gültige Daten, wenn das Beziehungselement RelationCache ist.

Windows Server 2003: Dieser Member wird erst unter Windows Server 2003 mit SP1 und Windows XP Professional x64 Edition unterstützt.

DUMMYUNIONNAME.Reserved[2]

Reserviert. Darf nicht verwendet werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista, Windows XP Professional x64 Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile winnt.h (Einschließen von Windows.h)

Weitere Informationen

CACHE_DESCRIPTOR

GetLogicalProcessorInformation

GetLogicalProcessorInformationEx

LOGICAL_PROCESSOR_RELATIONSHIP

SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX