Función GetNumaProximityNode (winbase.h)

  • Artículo

Recupera el número de nodo NUMA que corresponde al identificador de dominio de proximidad especificado.

Use la función GetNumaProximityNodeEx para recuperar el número de nodo como un valor de USHORT .

Sintaxis

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

Parámetros

[in] ProximityId

Identificador de dominio de proximidad del nodo.

[out] NodeNumber

Número de nodo. Si el procesador no existe, este parámetro se 0xFF.

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. Para obtener información de error extendida, llame a GetLastError.

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 expone ninguna función de Windows. Para obtener más información sobre las tablas ACPI, consulte las especificaciones ACPI.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winbase.h (incluya Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

GetNumaProcessorNode

GetNumaProximityNodeEx

Compatibilidad NUMA