Funzione GetNumaProximityNode (winbase.h)

  • Articolo

Recupera il numero di nodo NUMA corrispondente all'identificatore di dominio di prossimità specificato.

Usare la funzione GetNumaProximityNodeEx per recuperare il numero di nodo come valore USHORT .

Sintassi

BOOL GetNumaProximityNode(
  [in]  ULONG  ProximityId,
  [out] PUCHAR NodeNumber
);

Parametri

[in] ProximityId

Identificatore di dominio di prossimità del nodo.

[out] NodeNumber

Numero di nodo. Se il processore non esiste, questo parametro è 0xFF.

Valore restituito

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

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

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.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winbase.h (include Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

GetNumaProcessorNode

GetNumaProximityNodeEx

Supporto NUMA