Función GetNumaProximityNodeEx (systemtopologyapi.h)
Recupera el número de nodo NUMA que corresponde al identificador de proximidad especificado como un valor de USHORT .
Sintaxis
BOOL GetNumaProximityNodeEx(
[in] ULONG ProximityId,
[out] PUSHORT NodeNumber
);
Parámetros
[in] ProximityId
Identificador de proximidad del nodo.
[out] NodeNumber
Apunta a una variable para recibir el número de nodo del identificador de proximidad especificado.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero.
Comentarios
Un identificador de dominio de proximidad es un índice de un nodo NUMA en un sistema NUMA. Los identificadores de dominio de proximidad se encuentran en la tabla de afinidad de recursos del sistema ACPI (SRAT), donde se usan para asociar procesadores y regiones de memoria con un nodo NUMA determinado. Los identificadores de dominio de proximidad también se encuentran en el espacio de nombres ACPI, donde se usan para asociar un dispositivo a un nodo NUMA determinado. Normalmente, los identificadores de dominio de proximidad solo se usan en las aplicaciones de administración proporcionadas por los fabricantes del sistema. Windows no usa identificadores de dominio de proximidad para identificar nodos NUMA; en su lugar, asigna un número único a cada nodo NUMA del sistema.
La distancia relativa entre los nodos de un sistema se almacena en la tabla de información de distancia de localidad del sistema ACPI (SLIT), que no está expuesta por ninguna función de Windows. Para obtener más información sobre las tablas ACPI, consulte las especificaciones ACPI.
La única diferencia entre la función GetNumaProximityNodeEx y la función GetNumaProximityNode es el tipo de datos del parámetro NodeNumber .
Para compilar una aplicación que usa esta función, establezca _WIN32_WINNT >= 0x0601. Para obtener más información, vea Usar los encabezados de Windows.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | systemtopologyapi.h (incluya Windows.h) |
| Library | Kernel32.lib |
| Archivo DLL | Kernel32.dll |