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 de nó baseado em zero para o nó de interesse.

ProcessorMasks

Uma matriz de estruturas 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 no qual 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 retornado

Se a função for bem-sucedida, o valor retornado será diferente de 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 de erro será ERROR_INVALID_PARAMETER.

Comentários

Se o nó especificado não tiver processadores associados 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.

Requisitos

Confira também

GetMaximumProcessorGroupCount