SYSTEM_LOGICAL_PROCESSOR_INFORMATION-Struktur (winnt.h)
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.
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
GetLogicalProcessorInformation
GetLogicalProcessorInformationEx