GetNumaProximityNode-Funktion (winbase.h)

  • Artikel

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

Siehe auch

GetNumaProcessorNode

GetNumaProximityNodeEx

NUMA-Unterstützung