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
);

Die Parameter

[in] ProximityId

Der Näherungsbezeichner des Knotens.

[out] NodeNumber

Verweist 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 fehlschlägt, ist der Rückgabewert null.

Bemerkungen

Ein Näherungsdomänenbezeichner ist ein Index zu einem NUMA-Knoten in einem NUMA-System. Näherungsdomänen-IDs werden in der ACPI-Systemressourcenaffinitätstabelle (ACPI System Affinity Table, SRAT) gefunden, in der sie zum Zuordnen von Prozessoren und Speicherbereichen zu einem bestimmten NUMA-Knoten verwendet werden. Näherungsdomänen-IDs befinden sich auch im ACPI-Namespace, in dem sie verwendet werden, um ein Gerät einem bestimmten NUMA-Knoten 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 Nummer zugewiesen.

Der relative Abstand zwischen Knoten in einem System wird in der ACPI System Locality Distance Information Table (SLIT) gespeichert, die von windows-Funktionen nicht verfügbar gemacht wird. Weitere Informationen zu ACPI-Tabellen finden Sie in den ACPI-Spezifikationen.

Der einzige Unterschied zwischen der Funktion "GetNumaProximityNodeEx " und der Funktion "GetNumaProximityNode " 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

Siehe auch

GetNumaProximityNode

NUMA-Unterstützung