Função GetThreadSelectedCpuSetMasks (processthreadsapi.h)

Retorna a atribuição explícita do conjunto de CPU do thread especificado, se alguma 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 direito de acesso PROCESS_QUERY_LIMITED_INFORMATION . 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 pelo 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 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 RequiredMaskCount será definido como o número de elementos necessários.

Comentários

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 pelo thread são mapeados para seus processadores domésticos e esses processadores são recuperados na lista resultante de afinidades de grupo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 11
Servidor mínimo com suporte	Windows Server 2022
Cabeçalho	processthreadsapi.h
DLL	kernel32.dll