NdisGetProcessorInformationEx-Funktion (ndis.h)

Artikel
03/01/2024

Die NdisGetProcessorInformationEx-Funktion 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 instance Handle, das während der Initialisierung des Aufrufers abgerufen wurde. Ein Miniporttreiber kann beispielsweise das NDIS-Handle verwenden, das er von der Funktionen NdisMRegisterMiniportDriver oder MiniportInitializeEx . 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 gibt die Länge des Puffers im Parameter Size an.

[in, out] Size

Ein Zeiger auf einen Wert, der der Größe des vom Aufrufer bereitgestellten Puffers in Bytes entspricht. Wenn die Funktion zurückgibt, enthält dieser Wert entweder die Datenmenge, die NDIS in den Puffer eingefügt hat, oder die erforderliche Größe des Puffers, wenn der Puffer zu kurz war.

Rückgabewert

NdisGetProcessorInformationEx kann einen der folgenden status-Werte zurückgeben:

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

Hinweise

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.20 und höher.
Zielplattform	Universell
Header	ndis.h (include Ndis.h)
Bibliothek	Ndis.lib
IRQL	<= DISPATCH_LEVEL