Función GetNumaProximityNodeEx (systemtopologyapi.h)

Recupera el número de nodo NUMA que corresponde al identificador de proximidad especificado como un valor de USHORT .

Syntax

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 ejecuta correctamente, el valor devuelto es distinto de cero.

Si se produce un error en la función, el valor devuelto es cero.

Observaciones

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 los usan 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 distancia del sistema ACPI (SLIT), que no expone 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 use esta función, establezca _WIN32_WINNT >= 0x0601. Para obtener más información, vea Using the Windows Headers.

Requisitos

Consulte también

GetNumaProximityNode

Compatibilidad con NUMA