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
| Cliente mínimo com suporte | Windows 10 Build 20348 |
| Servidor mínimo com suporte | Windows 10 Build 20348 |
| Cabeçalho | systemtopologyapi.h |