Função GetNumaNodeProcessorMask2 (systemtopologyapi.h)

Recupera a máscara de processador de vários grupos do nó especificado.

Sintaxe

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

Parâmetros

NodeNumber

Fornece o número do nó baseado em zero para o nó de interesse.

ProcessorMasks

Uma matriz de estruturas de GROUP_AFFINITY , que após o retorno bem-sucedido descreve a máscara de processador do nó especificado.

Cada elemento na matriz descreve um conjunto de processadores que pertencem ao nó dentro de um único grupo de processadores. Haverá um elemento na matriz resultante para cada grupo de processadores em que esse nó tem processadores ativos.

ProcessorMaskCount

Especifica o tamanho da matriz ProcessorMasks , em elementos.

RequiredMaskCount

No retorno bem-sucedido, especifica o número de estruturas de afinidade gravadas na matriz.

Se a matriz de entrada for muito pequena, a função falhará com ERROR_INSUFFICIENT_BUFFER e definirá o parâmetro RequiredMaskCount como o número de elementos necessários.

O número de elementos necessários é sempre menor ou igual à contagem máxima de grupos retornada por GetMaximumProcessorGroupCount.

Valor de retorno

Se a função for bem-sucedida, o valor retornado não será zero.

Se a função falhar, o valor retornado será zero e as informações de erro estendidas poderão ser recuperadas chamando GetLastError.

Se a matriz fornecida for muito pequena, o valor de erro será ERROR_INSUFFICIENT_BUFFER e o parâmetro RequiredMaskCount será definido como o número de elementos necessários.

Se o NodeNumber fornecido for inválido (ou seja, maior que o valor retornado por GetNumaHighestNodeNumber), o valor do erro será ERROR_INVALID_PARAMETER.

Observações

Se o nó especificado não tiver nenhum processador associado a ele (ou seja, ele contém apenas memória ou periféricos), o RequiredMaskCount retornado será 0 e nenhuma estrutura será gravada na matriz.

Requirements

Consulte também

GetMaximumProcessorGroupCount