GetNumaProcessorNode-Funktion (winbase.h)

Artikel
08/27/2023

Ruft die Knotennummer für den angegebenen Prozessor ab.

Verwenden Sie die GetNumaProcessorNodeEx-Funktion , um eine Prozessorgruppe anzugeben und die Knotennummer als USHORT-Wert abzurufen.

Syntax

BOOL GetNumaProcessorNode(
  [in]  UCHAR  Processor,
  [out] PUCHAR NodeNumber
);

Parameter

[in] Processor

Die Prozessornummer.

Auf einem System mit mehr als 64 logischen Prozessoren ist die Prozessornummer relativ zur Prozessorgruppe , die den Prozessor enthält, auf dem der aufrufende Thread ausgeführt wird.

[out] NodeNumber

Die Knotennummer. Wenn der Prozessor nicht vorhanden ist, wird dieser Parameter 0xFF.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Verwenden Sie die GetProcessAffinityMask-Funktion , um die Liste der Prozessoren im System abzurufen.

Beispiele

Ein Beispiel finden Sie unter Zuweisen von Arbeitsspeicher aus einem NUMA-Knoten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista, Windows XP Professional x64 Edition, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (Windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll