Função GetProcessGroupAffinity (processtopologyapi.h)
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 |