Share via

Función GetNumaProximityNodeEx (systemtopologyapi.h)

  • Artículo

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

Vea también

GetNumaProximityNode

Compatibilidad NUMA