SYSTEM_CPU_SET_INFORMATION-Struktur (winnt.h)

Diese Struktur wird von GetSystemCpuSetInformation zurückgegeben. Es wird verwendet, um die CPU-Sätze auf dem System aufzulisten und ihren aktuellen Zustand zu bestimmen.

Hierbei handelt es sich um eine Struktur mit variabler Größe, die für zukünftige Erweiterungen konzipiert ist. Verwenden Sie beim Durchlaufen dieser Struktur das Feld größe, um den Offset zur nächsten Struktur zu bestimmen.

Syntax

typedef struct _SYSTEM_CPU_SET_INFORMATION {
  DWORD                    Size;
  CPU_SET_INFORMATION_TYPE Type;
  union {
    struct {
      DWORD   Id;
      WORD    Group;
      BYTE    LogicalProcessorIndex;
      BYTE    CoreIndex;
      BYTE    LastLevelCacheIndex;
      BYTE    NumaNodeIndex;
      BYTE    EfficiencyClass;
      union {
        BYTE AllFlags;
        struct {
          BYTE Parked : 1;
          BYTE Allocated : 1;
          BYTE AllocatedToTargetProcess : 1;
          BYTE RealTime : 1;
          BYTE ReservedFlags : 4;
        } DUMMYSTRUCTNAME;
      } DUMMYUNIONNAME2;
      union {
        DWORD Reserved;
        BYTE  SchedulingClass;
      };
      DWORD64 AllocationTag;
    } CpuSet;
  } DUMMYUNIONNAME;
} SYSTEM_CPU_SET_INFORMATION, *PSYSTEM_CPU_SET_INFORMATION;

Member

Size

Dies ist die Größe dieser Informationsstruktur in Bytes.

Type

Dies ist der Typ der Informationen in der Struktur. Anwendungen sollten alle Strukturen mit nicht erkannten Typen überspringen.

DUMMYUNIONNAME

DUMMYUNIONNAME.CpuSet

DUMMYUNIONNAME.CpuSet.Id

Die ID des angegebenen CPU-Satzes. Dieser Bezeichner kann mit SetProcessDefaultCpuSets oder SetThreadSelectedCpuSets verwendet werden, wenn eine Liste von CPU-Sätzen angegeben wird, für die eine Affinität besteht.

DUMMYUNIONNAME.CpuSet.Group

Gibt die Prozessorgruppe der CPU-Gruppe an. Alle anderen Werte in der CpuSet-Struktur sind relativ zur Prozessorgruppe.

DUMMYUNIONNAME.CpuSet.LogicalProcessorIndex

Gibt den gruppenrelativen Index des Basisprozessors des CPU-Satz an. Sofern der CPU-Satz nicht aus Gründen der Wärme- oder Energieverwaltung geparkt oder einer anderen Anwendung zur ausschließlichen Verwendung zugewiesen wird, werden Threads auf dem Heimprozessor eines ihrer CPU-Sätze ausgeführt. Die Felder Group und LogicalProcessorIndex sind identisch mit denen in der PROCESSOR_NUMBER-Struktur und entsprechen dem Feld Group und Mask der GROUP_AFFINITY-Struktur.

DUMMYUNIONNAME.CpuSet.CoreIndex

Ein gruppenrelativer Wert, der angibt, welcher "Core" über den Basisprozessor des CPU-Satz verfügt. Diese Zahl ist für alle CPU-Sätze in derselben Gruppe identisch, die erhebliche Ausführungsressourcen miteinander teilen, z. B. verschiedene Hardwarethreads auf einem einzelnen Kern, der gleichzeitiges Multithreading unterstützt.

DUMMYUNIONNAME.CpuSet.LastLevelCacheIndex

Ein gruppenrelativer Wert, der angibt, welche CPU-Sätze mindestens eine Cacheebene miteinander teilen. Dieser Wert ist für alle CPU-Sätze in einer Gruppe identisch, die sich auf Prozessoren befinden, die den Cache miteinander teilen.

DUMMYUNIONNAME.CpuSet.NumaNodeIndex

Ein gruppenrelativer Wert, der angibt, auf welchem NUMA-Knoten sich ein CPU-Satz befindet. Alle CPU-Sätze in einer bestimmten Gruppe, die sich auf demselben NUMA-Knoten befinden, weisen den gleichen Wert für dieses Feld auf.

DUMMYUNIONNAME.CpuSet.EfficiencyClass

Ein Wert, der die intrinsische Energieeffizienz eines Prozessors für Systeme angibt, die heterogene Prozessoren unterstützen (z. B. ARM big). LITTLE-Systeme). CPU-Sets mit höheren numerischen Werten dieses Felds verfügen über Homeprozessoren, die schneller, aber weniger energieeffizient sind als solche mit niedrigeren Werten.

DUMMYUNIONNAME.CpuSet.DUMMYUNIONNAME2

DUMMYUNIONNAME.CpuSet.DUMMYUNIONNAME2.AllFlags

DUMMYUNIONNAME.CpuSet.DUMMYUNIONNAME2.DUMMYSTRUCTNAME

DUMMYUNIONNAME.CpuSet.DUMMYUNIONNAME2.DUMMYSTRUCTNAME.Parked

DUMMYUNIONNAME.CpuSet.DUMMYUNIONNAME2.DUMMYSTRUCTNAME.Allocated

DUMMYUNIONNAME.CpuSet.DUMMYUNIONNAME2.DUMMYSTRUCTNAME.AllocatedToTargetProcess

DUMMYUNIONNAME.CpuSet.DUMMYUNIONNAME2.DUMMYSTRUCTNAME.RealTime

DUMMYUNIONNAME.CpuSet.DUMMYUNIONNAME2.DUMMYSTRUCTNAME.ReservedFlags

DUMMYUNIONNAME.CpuSet.Reserved

Reserviert.

DUMMYUNIONNAME.CpuSet.SchedulingClass

DUMMYUNIONNAME.CpuSet.AllocationTag

Gibt ein Tag an, das von der Core Allocation verwendet wird, um einen bestimmten zugeordneten CPU-Satz zwischen Threads in verschiedenen Komponenten zu kommunizieren.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [Desktop-Apps | UWP-Apps]
Kopfzeile	winnt.h (Einschließen von Windows.h)