GetNumaNodeProcessorMask-Funktion (winbase.h)

Artikel
03/06/2024

Ruft die Prozessormaske für den angegebenen Knoten ab.

Syntax

BOOL GetNumaNodeProcessorMask(
  [in]  UCHAR      Node,
  [out] PULONGLONG ProcessorMask
);

Parameter

[in] Node

Die Nummer des Knotens.

[out] ProcessorMask

Die Prozessormaske für den Knoten. Eine Prozessormaske ist ein Bitvektor, in dem jedes Bit einen Prozessor darstellt und ob es sich im Knoten befindet.

Wenn für den Knoten keine Prozessoren konfiguriert sind, ist die Prozessormaske null.

Auf Systemen mit mehr als 64 Prozessoren wird dieser Parameter nur dann auf die Prozessormaske für den Knoten festgelegt, wenn sich der Knoten in derselben Prozessorgruppe wie der aufrufende Thread befindet. Andernfalls wird der Parameter auf 0 (null) festgelegt.

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 GetNumaHighestNodeNumber-Funktion , um den höchsten nummerierten Knoten im System abzurufen. Beachten Sie, dass diese Zahl nicht garantiert der Gesamtzahl der Knoten im System entspricht.

Um sicherzustellen, dass alle Threads für Ihren Prozess auf demselben Knoten ausgeführt werden, verwenden Sie die SetProcessAffinityMask-Funktion mit einer Prozessaffinitätsmaske, die Prozessoren im selben Knoten angibt.

Verwenden Sie die GetNumaNodeProcessorMaskEx-Funktion , um die Prozessormaske für einen Knoten in einer beliebigen Prozessorgruppe abzurufen.

Hinweis

Ab TBD Release Iron wurde das Verhalten dieser und anderer NUMA-Funktionen geändert, um Systeme mit Knoten mit mehr als 64 Prozessoren besser zu unterstützen. Weitere Informationen zu dieser Änderung, einschließlich Informationen zum Aktivieren des alten Verhaltens dieser API, finden Sie unter NUMA-Unterstützung.

Verhalten ab TBD Release Iron

Jedem Knoten wird vom System eine primäre Gruppe zugewiesen. Die von GetNumaNodeProcessorMask zurückgegebene Maske gilt für die primäre Gruppe des Knotens und wird nur zurückgegeben, wenn der aufrufende Thread zu dieser Gruppe gehört.

Verhalten in früheren Versionen

Die Maske für den angegebenen Knoten wird zurückgegeben.

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