Función GetNumaNodeProcessorMask2 (systemtopologyapi.h)

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

Syntax

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

RequiredMaskCount

Al devolver correctamente, especifica el número de estructuras de afinidad escritas en la matriz.

Si la matriz de entrada era demasiado pequeña, la función produce un error 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 ejecuta correctamente, el valor devuelto es distinto de cero.

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

Si la matriz proporcionada es demasiado pequeña, el valor de error es 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.

Observaciones

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

Consulte también

GetMaximumProcessorGroupCount