Função KeQueryGroupAffinity (ntddk.h)
A rotina KeQueryGroupAffinity retorna uma máscara de afinidade que identifica os processadores lógicos ativos em um grupo especificado em um sistema multiprocessador.
Sintaxe
KAFFINITY KeQueryGroupAffinity(
[in] USHORT GroupNumber
);
Parâmetros
[in] GroupNumber
O número do grupo. Se um sistema multiprocessador contiver n grupos, os grupos serão numerados de 0 a n-1. Para obter o número de grupos ativos no sistema, chame a rotina KeQueryActiveGroupCount .
Retornar valor
KeQueryGroupAffinity retorna um valor KAFFINITY que identifica os processadores lógicos ativos no grupo especificado. Se o valor do parâmetro GroupNumber não for um número de grupo válido, a rotina retornará zero.
Comentários
Uma rotina relacionada, KeQueryActiveProcessors, retorna uma máscara de afinidade que representa um conjunto de processadores ativos, mas essa rotina, ao contrário de KeQueryGroupAffinity, não aceita um número de grupo como um parâmetro de entrada. No Windows 7 e versões posteriores do sistema operacional Windows, KeQueryActiveProcessors retorna uma máscara de afinidade para os processadores ativos no grupo 0, que é compatível com o comportamento dessa rotina em versões anteriores do Windows que não dão suporte a grupos. Esse comportamento garante que os drivers existentes que chamam KeQueryActiveProcessors e que não usam recursos orientados a grupos sejam executados corretamente em sistemas multiprocessadores que têm dois ou mais grupos. No entanto, os drivers que usam recursos orientados a grupos no Windows 7 e versões posteriores do sistema operacional Windows devem chamar KeQueryGroupAffinity em vez de KeQueryActiveProcessors.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows 7 e versões posteriores do Windows. |
| Plataforma de Destino | Universal |
| Cabeçalho | ntddk.h (inclua Wdm.h, Ntddk.h, Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Qualquer nível |