Función GetNumaNodeProcessorMaskEx (systemtopologyapi.h)
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 |