GetNumaNodeProcessorMask-Funktion (winbase.h)
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 |