GetNumaNodeProcessorMaskEx-Funktion (systemtopologyapi.h)

Artikel
03/02/2024

Ruft die Prozessormaske für einen Knoten ab, unabhängig von der Prozessorgruppe, zu der der Knoten gehört.

Syntax

BOOL GetNumaNodeProcessorMaskEx(
  [in]  USHORT          Node,
  [out] PGROUP_AFFINITY ProcessorMask
);

Parameter

[in] Node

Die Knotennummer.

[out] ProcessorMask

Ein Zeiger auf eine GROUP_AFFINITY Struktur, die die Prozessormaske für den angegebenen Knoten empfängt. Eine Prozessormaske ist ein Bitvektor, in dem jedes Bit einen Prozessor darstellt und ob es sich im Knoten befindet.

Wenn für den angegebenen Knoten keine Prozessoren konfiguriert sind, ist das Mask-Element null und das Gruppenelement nicht definiert.

Rückgabewert

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

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Die GetNumaNodeProcessorMaskEx-Funktion unterscheidet sich von GetNumaNodeProcessorMask dadurch, dass sie die Prozessormaske für einen Knoten abrufen kann, unabhängig von der Gruppe, zu der der Knoten gehört. Das heißt, der Knoten muss sich nicht in derselben Gruppe wie der aufrufende Thread befinden. Die GetNumaNodeProcessorMask-Funktion kann die Prozessormaske nur für Knoten abrufen, die sich in derselben Gruppe wie der aufrufende Thread befinden.

Um den höchsten nummerierten Knoten im System abzurufen, verwenden Sie die GetNumaHighestNodeNumber-Funktion . Beachten Sie, dass diese Zahl nicht garantiert der Gesamtanzahl von 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 gleichen Knoten angibt.

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, legen Sie _WIN32_WINNT>= 0x0601 fest. Weitere Informationen finden Sie unter Verwenden der Windows-Header.

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 vonGetNumaNodeProcessorMaskEx zurückgegebene GROUP_AFFINITY ist für die primäre Gruppe des Knotens.

Verhalten in früheren Versionen

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	systemtopologyapi.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll