Función GetNumaNodeProcessorMask2 (systemtopologyapi.h)

Recupera la máscara de procesador de varios grupos del nodo especificado.

Sintaxis

BOOL GetNumaNodeProcessorMask2(
  USHORT          NodeNumber,
  PGROUP_AFFINITY ProcessorMasks,
  USHORT          ProcessorMaskCount,
  PUSHORT         RequiredMaskCount
);

Parámetros

NodeNumber

Proporciona el número de nodo de base cero para el nodo de interés.

ProcessorMasks

Matriz de estructuras de GROUP_AFFINITY , que, tras devolverse correctamente, describe la máscara de procesador del nodo especificado.

Cada elemento de la matriz describe un conjunto de procesadores que pertenecen al nodo dentro de un único grupo de procesadores. Habrá un elemento en la matriz resultante para cada grupo de procesadores en el que este nodo tiene procesadores activos.

ProcessorMaskCount

Especifica el tamaño de la matriz ProcessorMasks , en los elementos .

RequiredMaskCount

Si la devolución es correcta, especifica el número de estructuras de afinidad escritas en la matriz.

Si la matriz de entrada era demasiado pequeña, se produce un error en la función con ERROR_INSUFFICIENT_BUFFER y establece el parámetro RequiredMaskCount en el número de elementos necesarios.

El número de elementos necesarios es siempre menor o igual que el número máximo de grupos devuelto por GetMaximumProcessorGroupCount.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si se produce un error en la función, el valor devuelto es cero y la información de error extendida se puede recuperar llamando a GetLastError.

Si la matriz proporcionada es demasiado pequeña, el valor de error se ERROR_INSUFFICIENT_BUFFER y el parámetro RequiredMaskCount se establece en el número de elementos necesarios.

Si nodeNumber proporcionado no es válido (es decir, mayor que el valor devuelto por GetNumaHighestNodeNumber), el valor de error es ERROR_INVALID_PARAMETER.

Comentarios

Si el nodo especificado no tiene ningún procesador asociado (es decir, solo contiene memoria o periféricos), el requiredMaskCount devuelto será 0 y no se escribirá ninguna estructura en la matriz.

Requisitos

Cliente mínimo compatible	Compilación 20348 de Windows 10
Servidor mínimo compatible	Compilación 20348 de Windows 10
Encabezado	systemtopologyapi.h

Consulte también

GetMaximumProcessorGroupCount