Função KeQueryGroupAffinity (ntddk.h)

  • Artigo

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

Confira também

KAFFINITY

KeQueryActiveProcessors