Función KeQueryGroupAffinity (wdm.h)
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 de, 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.
Observaciones
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 las características orientadas a grupos en Windows 7 y versiones posteriores del sistema operativo Windows deben llamar a KeQueryGroupAffinity en lugar de KeQueryActiveProcessors.
Requisitos
Requisito | Valor |
---|---|
cliente mínimo admitido | Disponible en Windows 7 y versiones posteriores de Windows. |
de la plataforma de destino de | Universal |
encabezado de | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
biblioteca de | NtosKrnl.lib |
DLL de | NtosKrnl.exe |
irQL | Cualquier nivel |