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.
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 |