Función GetNumaNodeProcessorMask (winbase.h)

Artículo
03/08/2023

Recupera la máscara de procesador para el nodo especificado.

Sintaxis

BOOL GetNumaNodeProcessorMask(
  [in]  UCHAR      Node,
  [out] PULONGLONG ProcessorMask
);

Parámetros

[in] Node

Número del nodo.

[out] ProcessorMask

Máscara de procesador para el nodo. Una máscara de procesador es un vector de bits en el que cada bit representa un procesador y si está en el nodo.

Si el nodo no tiene ningún procesador configurado, la máscara de procesador es cero.

En los sistemas con más de 64 procesadores, este parámetro se establece en la máscara de procesador para el nodo solo si el nodo está en el mismo grupo de procesadores que el subproceso que realiza la llamada. De lo contrario, el parámetro se establece en cero.

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

Para recuperar el nodo numerado más alto del sistema, use la función GetNumaHighestNodeNumber . Tenga en cuenta que no se garantiza que este número sea igual al número total de nodos del sistema.

Para asegurarse de que todos los subprocesos del proceso se ejecutan en el mismo nodo, use la función SetProcessAffinityMask con una máscara de afinidad de proceso que especifique procesadores en el mismo nodo.

Use la función GetNumaNodeProcessorMaskEx para recuperar la máscara de procesador de un nodo de cualquier grupo de procesadores.

Nota

A partir de TBD Release Iron, el comportamiento de esta y otras funciones NUMA se ha modificado para admitir mejor los sistemas con nodos que contienen más de 64 procesadores. Para obtener más información sobre este cambio, incluida la información sobre cómo habilitar el comportamiento anterior de esta API, consulte Compatibilidad con NUMA.

Comportamiento a partir de TBD Release Iron

El sistema asigna un grupo principal a cada nodo. La máscara devuelta por GetNumaNodeProcessorMask es para el grupo principal del nodo y solo se devuelve si el subproceso que realiza la llamada pertenece a ese grupo.

Comportamiento en versiones anteriores

Se devuelve la máscara del nodo especificado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista, Windows XP Professional x64 Edition, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winbase.h (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll