GetNumaProximityNodeEx-Funktion (systemtopologyapi.h)
Ruft die NUMA-Knotennummer ab, die dem angegebenen Näherungsbezeichner als USHORT-Wert entspricht.
Syntax
BOOL GetNumaProximityNodeEx(
[in] ULONG ProximityId,
[out] PUSHORT NodeNumber
);
Parameter
[in] ProximityId
Der Näherungsbezeichner des Knotens.
[out] NodeNumber
Zeigt auf eine Variable, um die Knotennummer für den angegebenen Näherungsbezeichner zu empfangen.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
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 Speicherregionen einem bestimmten NUMA-Knoten zuzuordnen. Näherungsdomänenbezeichner befinden sich auch im ACPI-Namespace, wo sie verwendet werden, um einem bestimmten NUMA-Knoten ein Gerät zuzuordnen. Näherungsdomänenbezeichner 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 weist sie jedem NUMA-Knoten im System eine eindeutige Zahl zu.
Der relative Abstand zwischen Knoten auf 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.
Der einzige Unterschied zwischen der GetNumaProximityNodeEx-Funktion und der GetNumaProximityNode-Funktion ist der Datentyp des NodeNumber-Parameters .
Um eine Anwendung zu kompilieren, die diese Funktion verwendet, legen Sie _WIN32_WINNT >= 0x0601 fest. Weitere Informationen finden Sie unter Verwenden der Windows-Header.
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 |