Funzione GetNumaProximityNodeEx (systemtopologyapi.h)

  • Articolo

Recupera il numero di nodo NUMA corrispondente all'identificatore di prossimità specificato come valore USHORT .

Sintassi

BOOL GetNumaProximityNodeEx(
  [in]  ULONG   ProximityId,
  [out] PUSHORT NodeNumber
);

Parametri

[in] ProximityId

Identificatore di prossimità del nodo.

[out] NodeNumber

Punta a una variabile per ricevere il numero di nodo per l'identificatore di prossimità specificato.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

Un identificatore di dominio di prossimità è un indice a un nodo NUMA in un sistema NUMA. Gli identificatori di dominio di prossimità sono disponibili nella tabella di affinità delle risorse del sistema ACPI (SRAT), in cui vengono usati per associare processori e aree di memoria a un determinato nodo NUMA. Gli identificatori di dominio di prossimità sono disponibili anche nello spazio dei nomi ACPI, in cui vengono usati per associare un dispositivo a un determinato nodo NUMA. Gli identificatori di dominio di prossimità vengono in genere usati solo dalle applicazioni di gestione fornite dai produttori di sistema. Windows non usa identificatori di dominio di prossimità per identificare i nodi NUMA; assegna invece un numero univoco a ogni nodo NUMA nel sistema.

La distanza relativa tra i nodi in un sistema viene archiviata nella tabella delle informazioni sulla distanza della distanza del sistema ACPI (SLIT), che non è esposta da alcuna funzione di Windows. Per altre informazioni sulle tabelle ACPI, vedere le specifiche ACPI.

L'unica differenza tra la funzione GetNumaProximityNodeEx e la funzione GetNumaProximityNode è il tipo di dati del parametro NodeNumber.

Per compilare un'applicazione che usa questa funzione, impostare _WIN32_WINNT = 0x0601 >. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione systemtopologyapi.h (includere Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

GetNumaProximityNode

Supporto NUMA