Función GetNumaNodeProcessorMaskEx (systemtopologyapi.h)

Artículo
03/02/2024

Recupera la máscara de procesador de un nodo independientemente del grupo de procesadores al que pertenece el nodo.

Sintaxis

BOOL GetNumaNodeProcessorMaskEx(
  [in]  USHORT          Node,
  [out] PGROUP_AFFINITY ProcessorMask
);

Parámetros

[in] Node

Número de nodo.

[out] ProcessorMask

Puntero a una estructura de GROUP_AFFINITY que recibe la máscara de procesador para el nodo especificado. 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 especificado no tiene ningún procesador configurado, el miembro Mask es cero y el miembro Group no está definido.

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

La función GetNumaNodeProcessorMaskEx difiere de GetNumaNodeProcessorMask en que puede recuperar la máscara de procesador de un nodo independientemente del grupo al que pertenece el nodo. Es decir, el nodo no tiene que estar en el mismo grupo que el subproceso que realiza la llamada. La función GetNumaNodeProcessorMask solo puede recuperar la máscara del procesador para los nodos que están en el mismo grupo que el subproceso que realiza la llamada.

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.

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.

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 a cada nodo un grupo principal. El GROUP_AFFINITY devuelto por GetNumaNodeProcessorMaskEx es para el grupo principal del nodo.

Comportamiento en versiones anteriores

Se devuelve el GROUP_AFFINITY del nodo especificado.

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