GetNumaProximityNode-Funktion (winbase.h)
Ruft die NUMA-Knotennummer ab, die dem angegebenen Näherungsdomänenbezeichner entspricht.
Verwenden Sie die GetNumaProximityNodeEx-Funktion , um die Knotennummer als USHORT-Wert abzurufen.
Syntax
BOOL GetNumaProximityNode(
[in] ULONG ProximityId,
[out] PUCHAR NodeNumber
);
Parameter
[in] ProximityId
Der Näherungsdomänenbezeichner des Knotens.
[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
Ein Näherungsdomänenbezeichner ist ein Index für einen NUMA-Knoten auf einem NUMA-System. Näherungsdomänenbezeichner befinden sich in der ACPI-Systemressourcenaffinitätstabelle (SRAT), wo sie verwendet werden, um Prozessoren und Speicherbereiche einem bestimmten NUMA-Knoten zuzuordnen. Näherungsdomänen-IDs befinden sich auch im ACPI-Namespace, wo sie verwendet werden, um einem bestimmten NUMA-Knoten ein Gerät zuzuordnen. Näherungsdomänen-IDs werden in der Regel nur von Verwaltungsanwendungen verwendet, die von Systemherstellern bereitgestellt werden. Windows verwendet keine Näherungsdomänenbezeichner, um NUMA-Knoten zu identifizieren. Stattdessen wird jedem NUMA-Knoten im System eine eindeutige Zahl zugewiesen.
Der relative Abstand zwischen knoten in einem System wird in der ACPI System Locality Distance Information Table (SLIT) gespeichert, die von keiner Windows-Funktion verfügbar gemacht wird. Weitere Informationen zu ACPI-Tabellen finden Sie in den ACPI-Spezifikationen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winbase.h (Windows.h einschließen) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |