Função GetThreadGroupAffinity (processtopologyapi.h)

Recupera a afinidade do grupo de processadores do thread especificado.

Sintaxe

BOOL GetThreadGroupAffinity(
  [in]  HANDLE          hThread,
  [out] PGROUP_AFFINITY GroupAffinity
);

Parâmetros

[in] hThread

Um identificador para o thread para o qual a afinidade do grupo de processadores é desejada.

O identificador deve ter o acesso THREAD_QUERY_INFORMATION ou THREAD_QUERY_LIMITED_INFORMATION direito. Para obter mais informações, consulte de Direitos de Acesso e Segurança do Thread.

[out] GroupAffinity

Um ponteiro para uma estrutura GROUP_AFFINITY que recebe a afinidade de grupo do thread.

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. Para obter informações de erro estendidas, use GetLastError.

Observações

A partir do Windows 11 e do Windows Server 2022, em um sistema com mais de 64 processadores, afinidades de processo e thread abrangem todos os processadores do sistema, em todos os grupos de processadores , por padrão. A função GetThreadGroupAffinity recupera a afinidade de grupo sobre o grupo primário do thread.

Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT >= 0x0601. Para obter mais informações, consulte Usando os cabeçalhos do Windows.

Requisitos

Consulte também

getProcessGroupAffinity

grupos de processadores