Partilhar via


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 de 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 de GROUP_AFFINITY que representam os Conjuntos de CPU a serem definidos como o conjunto de CPU selecionado por thread. Se isso 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 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.

Observações

Essa função é análoga a SetThreadSelectedCpuSets, exceto por usar 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.

Requirements

Requirement Value
Cliente mínimo suportado Windows 11
servidor com suporte mínimo Windows Server 2022
Header processthreadsapi.h
Library kernel32. Lib
DLL kernel32.dll