SYSTEM_INFO-Struktur (sysinfoapi.h)

Artikel
03/02/2024

Enthält Informationen zum aktuellen Computersystem. Dies umfasst die Architektur und den Typ des Prozessors, die Anzahl der Prozessoren im System, die Seitengröße und andere solche Informationen.

Syntax

typedef struct _SYSTEM_INFO {
  union {
    DWORD dwOemId;
    struct {
      WORD wProcessorArchitecture;
      WORD wReserved;
    } DUMMYSTRUCTNAME;
  } DUMMYUNIONNAME;
  DWORD     dwPageSize;
  LPVOID    lpMinimumApplicationAddress;
  LPVOID    lpMaximumApplicationAddress;
  DWORD_PTR dwActiveProcessorMask;
  DWORD     dwNumberOfProcessors;
  DWORD     dwProcessorType;
  DWORD     dwAllocationGranularity;
  WORD      wProcessorLevel;
  WORD      wProcessorRevision;
} SYSTEM_INFO, *LPSYSTEM_INFO;

Member

DUMMYUNIONNAME

DUMMYUNIONNAME.dwOemId

Ein veraltetes Element, das aus Kompatibilitätsgründen beibehalten wird. Anwendungen sollten den wProcessorArchitecture-Branch der Union verwenden.

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.wProcessorArchitecture

Die Prozessorarchitektur des installierten Betriebssystems. Dieser Member kann einer der folgenden Werte sein.

Wert	Bedeutung
PROCESSOR_ARCHITECTURE_AMD64 9	x64 (AMD oder Intel)
PROCESSOR_ARCHITECTURE_ARM 5	ARM
PROCESSOR_ARCHITECTURE_ARM64 12	ARM64
PROCESSOR_ARCHITECTURE_IA64 6	Intel Itanium-basiert
PROCESSOR_ARCHITECTURE_INTEL 0	x86
PROCESSOR_ARCHITECTURE_UNKNOWN 0xffff	Unbekannte Architektur.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.wReserved

Dieses Element ist für die zukünftige Verwendung reserviert.

dwPageSize

Die Seitengröße und die Granularität des Seitenschutzes und der Verpflichtung. Dies ist die Seitengröße, die von der VirtualAlloc-Funktion verwendet wird.

lpMinimumApplicationAddress

Ein Zeiger auf die niedrigste Speicheradresse, auf die Anwendungen und DLLs (Dynamic Link Libraries) zugegriffen werden kann.

lpMaximumApplicationAddress

Ein Zeiger auf die höchste Speicheradresse, die für Anwendungen und DLLs zugänglich ist.

dwActiveProcessorMask

Eine Maske, die den Satz von Prozessoren darstellt, die im System konfiguriert sind. Bit 0 ist Prozessor 0; Bit 31 ist Prozessor 31.

dwNumberOfProcessors

Die Anzahl der logischen Prozessoren in der aktuellen Gruppe. Verwenden Sie zum Abrufen der aktuellen Prozessorgruppe die GetLogicalProcessorInformation-Funktion .

Hinweis Um Informationen zu den physischen Prozessoren zu erhalten, die von logischen Prozessoren freigegeben werden, rufen Sie GetLogicalProcessorInformationEx auf, wobei der Parameter RelationshipType auf RelationProcessorPackage (3) festgelegt ist.

dwProcessorType

Ein veraltetes Element, das aus Kompatibilitätsgründen beibehalten wird. Verwenden Sie die Elemente wProcessorArchitecture, wProcessorLevel und wProcessorRevision , um den Prozessortyp zu bestimmen.

PROCESSOR_INTEL_386 (386)

PROCESSOR_INTEL_486 (486)

PROCESSOR_INTEL_PENTIUM (586)

PROCESSOR_INTEL_IA64 (2200)

PROCESSOR_AMD_X8664 (8664)

PROCESSOR_ARM (Reserviert)

dwAllocationGranularity

Die Granularität für die Startadresse, unter der der virtuelle Arbeitsspeicher zugeordnet werden kann. Weitere Informationen finden Sie unter VirtualAlloc.

wProcessorLevel

Die architekturabhängige Prozessorebene. Es sollte nur zu Anzeigezwecken verwendet werden. Um den Featuresatz eines Prozessors zu bestimmen, verwenden Sie die IsProcessorFeaturePresent-Funktion .

Wenn wProcessorArchitecture PROCESSOR_ARCHITECTURE_INTEL ist, wird wProcessorLevel vom CPU-Anbieter definiert.

Wenn wProcessorArchitecture PROCESSOR_ARCHITECTURE_IA64 ist, wird wProcessorLevel auf 1 festgelegt.

wProcessorRevision

Die architekturabhängige Prozessorrevision. Die folgende Tabelle zeigt, wie der Revisionswert für jeden Prozessorarchitekturtyp zusammengestellt wird.

Prozessor	Wert
Intel Pentium, Cyrix oder NextGen 586	Das hohe Byte ist das Modell, und das niedrige Byte ist das Stepping. Wenn der Wert beispielsweise xxyy ist, können Modellnummer und Schritt wie folgt angezeigt werden: Modell xx, Schritt yy
Intel 80386 oder 80486	Ein Wert des Formulars xxyz. Wenn xx gleich 0xFF ist, ist y - 0xA die Modellnummer und z der Schrittbezeichner. Wenn xx nicht gleich 0xFF ist, ist xx + "A" der Schrittbuchstaben und yz das nebenstehende Schrittschritt.
ARM	Reserviert.

Prozessor

Wert

Intel Pentium, Cyrix oder NextGen 586

Das hohe Byte ist das Modell, und das niedrige Byte ist das Stepping. Wenn der Wert beispielsweise xxyy ist, können Modellnummer und Schritt wie folgt angezeigt werden:

Modell xx, Schritt yy

Intel 80386 oder 80486

Ein Wert des Formulars xxyz.

Wenn xx gleich 0xFF ist, ist y - 0xA die Modellnummer und z der Schrittbezeichner.

Wenn xx nicht gleich 0xFF ist, ist xx + "A" der Schrittbuchstaben und yz das nebenstehende Schrittschritt.

ARM

Reserviert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Kopfzeile	sysinfoapi.h (einschließlich Windows.h)