Función GetNumaNodeProcessorMask (winbase.h)

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.

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

Vea también

GetNumaNodeProcessorMaskEx

GetNumaProcessorNode

Compatibilidad NUMA

Funciones de proceso y subproceso

SetProcessAffinityMask