Função GetThreadSelectedCpuSetMasks (processthreadsapi.h)

Retorna a atribuição explícita do conjunto de CPU do thread especificado, se qualquer atribuição foi definida usando SetThreadSelectedCpuSetMasks ou SetThreadSelectedCpuSets.

Sintaxe

BOOL GetThreadSelectedCpuSetMasks(
  HANDLE          Thread,
  PGROUP_AFFINITY CpuSetMasks,
  USHORT          CpuSetMaskCount,
  PUSHORT         RequiredMaskCount
);

Parâmetros

Thread

Especifica o thread para o qual consultar os Conjuntos de CPU selecionados. Esse identificador deve ter o acesso PROCESS_QUERY_LIMITED_INFORMATION correto. O valor retornado por GetCurrentProcess também pode ser especificado aqui.

CpuSetMasks

Especifica um buffer opcional para recuperar uma lista de estruturas de GROUP_AFFINITY que representam os conjuntos de CPU selecionados por thread.

CpuSetMaskCount

Especifica o tamanho da matriz CpuSetMasks, em elementos .

RequiredMaskCount

No retorno bem-sucedido, especifica o número de estruturas de afinidade gravadas na matriz. Se a matriz 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 RequiredMaskCount será definido como o número de elementos necessários.

Observações

Se nenhuma atribuição explícita for definida, RequiredMaskCount será definido como 0 e a função será bem-sucedida.

Essa função é análoga a GetThreadSelectedCpuSets, exceto que ela usa afinidades de grupo em vez de IDs de conjunto de CPU para representar uma lista de conjuntos de CPU. Isso significa que os conjuntos de CPU selecionados por thread são mapeados para seus processadores domésticos e esses processadores são recuperados na lista resultante de afinidades de grupo.

Requirements