Función KeQueryGroupAffinity (ntddk.h)

  • Artículo

La rutina KeQueryGroupAffinity devuelve una máscara de afinidad que identifica los procesadores lógicos activos de un grupo especificado en un sistema multiprocesador.

Sintaxis

KAFFINITY KeQueryGroupAffinity(
  [in] USHORT GroupNumber
);

Parámetros

[in] GroupNumber

Número de grupo. Si un sistema multiprocesador contiene n grupos, los grupos se numeran de 0 a n-1. Para obtener el número de grupos activos en el sistema, llame a la rutina KeQueryActiveGroupCount .

Valor devuelto

KeQueryGroupAffinity devuelve un valor KAFFINITY que identifica los procesadores lógicos activos del grupo especificado. Si el valor del parámetro GroupNumber no es un número de grupo válido, la rutina devuelve cero.

Comentarios

Una rutina relacionada, KeQueryActiveProcessors, devuelve una máscara de afinidad que representa un conjunto de procesadores activos, pero esta rutina, a diferencia de KeQueryGroupAffinity, no acepta un número de grupo como parámetro de entrada. En Windows 7 y versiones posteriores del sistema operativo Windows, KeQueryActiveProcessors devuelve una máscara de afinidad para los procesadores activos del grupo 0, que es compatible con el comportamiento de esta rutina en versiones anteriores de Windows que no admiten grupos. Este comportamiento garantiza que los controladores existentes que llaman a KeQueryActiveProcessors y que no usen características orientadas a grupos se ejecutarán correctamente en sistemas multiprocesador que tengan dos o más grupos. Sin embargo, los controladores que usan cualquier característica orientada a grupos en Windows 7 y versiones posteriores del sistema operativo Windows deben llamar a KeQueryGroupAffinity en lugar de KeQueryActiveProcessors.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows 7 y versiones posteriores de Windows.
Plataforma de destino Universal
Encabezado ntddk.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL Cualquier nivel

Consulte también

KAFFINITY

KeQueryActiveProcessors