GetNumaProximityNodeEx-Funktion (systemtopologyapi.h)

  • Artikel

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

Siehe auch

GetNumaProximityNode

NUMA-Unterstützung