Función KeQueryGroupAffinity (ntddk.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, 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 |