Funzione GetNumaProximityNodeEx (systemtopologyapi.h)
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.
Osservazioni
Un identificatore di dominio di prossimità è un indice di 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 particolare nodo NUMA. Gli identificatori di dominio di prossimità si trovano anche nello spazio dei nomi ACPI, dove 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 di 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.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 7 [solo app desktop] |
| server minimo supportato | Windows Server 2008 R2 [solo app desktop] |
| piattaforma di destinazione | Finestre |
| intestazione | systemtopologyapi.h (include Windows.h) |
| libreria | Kernel32.lib |
| dll | Kernel32.dll |