NdisGetProcessorInformationEx-Funktion (ndis.h)

Artikel
02/07/2025

Die funktion NdisGetProcessorInformationEx ruft Informationen zur CPU-Topologie des lokalen Computers ab.

Syntax

NDIS_STATUS NdisGetProcessorInformationEx(
  [in, optional]  NDIS_HANDLE                    NdisHandle,
  [out, optional] PNDIS_SYSTEM_PROCESSOR_INFO_EX SystemProcessorInfo,
  [in, out]       PSIZE_T                        Size
);

Parameter

[in, optional] NdisHandle

Ein NDIS-Treiber oder Instanzhandle, das während der Initialisierung des Aufrufers abgerufen wurde. Beispielsweise kann ein Miniporttreiber den NDIS-Handle verwenden, den er aus dem NdisMRegisterMiniportDriver oder MiniportInitializeEx--Funktionen. Andere NDIS-Treiber können die Handles aus den folgenden Funktionen verwenden:

NdisRegisterProtocolDriver-

NdisOpenAdapterEx

NdisFRegisterFilterDriver-

FilterAttach-

[out, optional] SystemProcessorInfo

Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, in dem NDIS die NDIS_SYSTEM_PROCESSOR_INFO_EX Struktur und ein Array von NDIS_PROCESSOR_INFO_EX Strukturen, die Informationen zur CPU-Topologie des lokalen Computers enthalten. Der Aufrufer stellt die Länge des Puffers im parameter Size bereit.

[in, out] Size

Ein Zeiger auf einen Wert, der die Größe des vom Aufrufer bereitgestellten Puffers in Bytes darstellt. Wenn die Funktion zurückgegeben wird, enthält dieser Wert entweder die Datenmenge, die NDIS im Puffer platziert hat, oder die erforderliche Größe des Puffers, wenn der Puffer zu kurz war.

Rückgabewert

NdisGetProcessorInformationEx- kann einen der folgenden Statuswerte zurückgeben:

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	Der Vorgang wurde erfolgreich abgeschlossen.
NDIS_STATUS_BUFFER_TOO_SHORT	Die Größe des Puffers am Size Parameter war zu klein. In diesem Fall stellt NDIS die erforderliche Puffergröße im Size Member bereit.

Bemerkungen

NDIS-Treiber rufen die NdisGetProcessorInformationEx--Funktion auf, um Informationen zu den Prozessoren auf dem lokalen Computer abzurufen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Unterstützt in NDIS 6.20 und höher.
Zielplattform-	Universal
Header-	ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL-	<= DISPATCH_LEVEL