Função SetThreadSelectedCpuSetMasks (processthreadsapi.h)

Define a atribuição de Conjuntos de CPU selecionada para o thread especificado. Essa atribuição substituirá a atribuição padrão do processo, se uma estiver definida.

Sintaxe

BOOL SetThreadSelectedCpuSetMasks(
  HANDLE          Thread,
  PGROUP_AFFINITY CpuSetMasks,
  USHORT          CpuSetMaskCount
);

Parâmetros

Thread

Especifica o thread no qual definir a atribuição do conjunto de CPU. PROCESS_SET_LIMITED_INFORMATION acesso à direita. O valor retornado por GetCurrentProcess também pode ser especificado aqui.

CpuSetMasks

Especifica um buffer opcional de estruturas GROUP_AFFINITY que representam os Conjuntos de CPU a serem definidos como o conjunto de CPU selecionado pelo thread. Se for NULL, a função SetThreadSelectedCpuSetMasks limpará qualquer atribuição, revertendo para processar a atribuição padrão se uma estiver definida.

CpuSetMaskCount

Especifica o número de estruturas de GROUP_AFFINITY na lista passadas no argumento GroupCpuSets. Se o buffer for NULL, esse valor deverá ser zero.

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.

Comentários

Essa função é análoga a SetThreadSelectedCpuSets, 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 a atribuição de Conjunto de CPU selecionada pelo thread resultante é o conjunto de todos os conjuntos de CPU com um processador doméstico na lista fornecida 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