Função GetProcessGroupAffinity (processtopologyapi.h)

  • Artigo

Recupera a afinidade do grupo de processadores do processo especificado.

Sintaxe

BOOL GetProcessGroupAffinity(
  [in]      HANDLE  hProcess,
  [in, out] PUSHORT GroupCount,
  [out]     PUSHORT GroupArray
);

Parâmetros

[in] hProcess

Um identificador para o processo.

Esse identificador deve ter o acesso PROCESS_QUERY_INFORMATION ou PROCESS_QUERY_LIMITED_INFORMATION correto. Para obter mais informações, consulte Direitos de Acesso e Segurança do Processo.

[in, out] GroupCount

Na entrada, especifica o número de elementos na matriz GroupArray . Na saída, especifica o número de grupos de processadores gravados na matriz. Se a matriz for muito pequena, a função falhará com ERROR_INSUFFICIENT_BUFFER e definirá o parâmetro GroupCount como o número de elementos necessários.

[out] GroupArray

Uma matriz de números de grupo de processadores. Um número de grupo será incluído na matriz se um thread no processo for atribuído a um processador no grupo.

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

Se o valor do erro for ERROR_INSUFFICIENT_BUFFER, o parâmetro GroupCount conterá o tamanho do buffer necessário em número de elementos.

Comentários

A partir do Windows 11 e do Windows Server 2022, em um sistema com mais de 64 processadores, as afinidades de processo e thread abrangem todos os processadores do sistema, em todos os grupos de processadores, por padrão.

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

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho processtopologyapi.h (inclua Windows.h no Windows Server 2008 Windows Server 2008 R2)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

GetThreadGroupAffinity

Grupos de processadores