NDIS_SYSTEM_PROCESSOR_INFO-Struktur (ndis.h)

Artikel
08/07/2023

Die NDIS_SYSTEM_PROCESSOR_INFO-Struktur gibt Informationen über die CPU-Topologie des lokalen Computers und den RSS-Prozessorsatz (Receive-Side Scaling) an.

Syntax

typedef struct _NDIS_SYSTEM_PROCESSOR_INFO {
  NDIS_OBJECT_HEADER    Header;
  ULONG                 Flags;
  NDIS_PROCESSOR_VENDOR ProcessorVendor;
  ULONG                 NumPhysicalPackages;
  ULONG                 NumCores;
  ULONG                 NumCoresPerPhysicalPackage;
  ULONG                 MaxHyperThreadingCpusPerCore;
  ULONG                 RssBaseCpu;
  ULONG                 RssCpuCount;
  PUCHAR                RssProcessors;
  NDIS_PROCESSOR_INFO   CpuInfo[MAXIMUM_PROC_PER_GROUP];
} NDIS_SYSTEM_PROCESSOR_INFO, *PNDIS_SYSTEM_PROCESSOR_INFO;

Member

Header

Die NDIS_OBJECT_HEADER-Struktur für die NDIS_SYSTEM_PROCESSOR_INFO-Struktur. Legen Sie den Typmember der Struktur, die Header angibt, auf NDIS_OBJECT_TYPE_DEFAULT, den Revisionsmember auf NDIS_SYSTEM_PROCESSOR_INFO_REVISION_1 und das Element Größe auf NDIS_SIZEOF_SYSTEM_PROCESSOR_INFO_REVISION_1 fest.

Flags

Reserviert. Legen Sie dieses Element auf 0 (null) fest.

ProcessorVendor

Der Prozessorhersteller, der als einer der Werte aus dem NDIS_PROCESSOR_VENDOR-Enumeration .

NumPhysicalPackages

Die Gesamtanzahl der physischen Prozessorpakete, die sich auf dem lokalen Computer befinden.

NumCores

Die Gesamtanzahl der Kernprozessoren, die sich auf dem lokalen Computer befinden. Legen Sie diesen Member beispielsweise auf vier fest, wenn zwei physische Pakete mit zwei Kernen vorhanden sind.

NumCoresPerPhysicalPackage

Die Anzahl der Kernprozessoren, die sich in jedem physischen Paket befinden. Legen Sie diesen Member beispielsweise für ein physisches Paket mit zwei Kernen fest.

MaxHyperThreadingCpusPerCore

Die maximale Anzahl logischer Prozessoren, die sich in jedem Hyperthreadkernprozessor befinden. Legen Sie diesen Member beispielsweise auf zwei fest, wenn jeder Hyperthreadprozessor zwei logische Prozessoren unterstützt.

RssBaseCpu

Die starte CPU-Nummer, die für RSS verwendet wird.

RssCpuCount

Die Anzahl der Prozessoren, die für RSS verwendet werden.

RssProcessors

Ein Zeiger auf einen optionalen vom Aufrufer bereitgestellten Puffer, der die CPU-Nummern der Prozessoren enthält, die für RSS verwendet werden können. Legen Sie diesen Member auf NULL fest, wenn die CPU-Nummern nicht erforderlich sind. Zum Abrufen von CPU-Nummern muss dieser Member einen gültigen Zeiger enthalten, und die Größe dieses Puffers muss mindestens MAXIMUM_PROCESSORS * sizeof (UCHAR) sein. Nach der Die NdisGetProcessorInformation-Funktion gibt erfolgreich zurück, der Puffer enthält CPU-Zahlen, gefolgt von nicht definierten Daten.

CpuInfo[MAXIMUM_PROC_PER_GROUP]

Ein Array von NDIS_PROCESSOR_INFO Strukturen. Nachdem die NdisGetProcessorInformation-Funktion erfolgreich zurückgegeben wurde, stellt dieses Array Informationen für jeden Prozessor auf dem lokalen Computer bereit. Die Anzahl der Werte im Array entspricht der Anzahl der Prozessoren auf dem lokalen Computer, wie die NdisSystemActiveProcessorCount-Funktionsberichte .

Hinweise

NDIS-Netzwerktreiber verwenden die NDIS_SYSTEM_PROCESSOR_INFO-Struktur in Aufrufen von NdisGetProcessorInformation-Funktion . Nach der Rückgabe von NdisGetProcessorInformation enthält diese Struktur Informationen zur CPU-Topologie des Systems und zu den Prozessoren, die für die empfangsseitige Skalierung (RSS) verwendet werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.0 und 6.1. Verwenden Sie für NDIS 6.20 und höher NDIS_SYSTEM_PROCESSOR_INFO_EX.
Kopfzeile	ndis.h (include Ndis.h)