Función KeQueryActiveGroupCount (ntddk.h)

La rutina KeQueryActiveGroupCount devuelve el número de grupos de procesadores activos en un sistema multiprocesador.

Sintaxis

USHORT KeQueryActiveGroupCount();

Valor devuelto

KeQueryActiveGroupCount devuelve un recuento de los grupos activos.

Comentarios

Un grupo de procesadores está activo si contiene uno o varios procesadores lógicos activos.

Un procesador lógico activo es un procesador lógico que Windows ha iniciado y agregado a un sistema multiprocesador. El término procesador activo se aplica a un procesador que está disponible para realizar el trabajo de procesamiento, independientemente de si el procesador está realizando actualmente el trabajo de procesamiento o está inactivo. En algunos sistemas, el número de procesadores activos puede permanecer sin cambios desde el inicio del sistema hasta el apagado. En otros sistemas, Windows podría agregar de forma dinámica procesadores activos mientras se ejecuta el sistema. Windows nunca quita procesadores activos de un sistema.

Por lo tanto, el número de procesadores activos en un sistema multiprocesador puede aumentar entre el inicio y el apagado del sistema, pero este número nunca disminuye. Del mismo modo, el número de grupos activos del sistema puede aumentar si un procesador se agrega dinámicamente a un grupo inactivo mientras se ejecuta el sistema. El número de grupos activos nunca disminuye.

Por el contrario, el valor devuelto por KeQueryMaximumGroupCount permanece constante durante el tiempo de ejecución. Este valor es el número máximo de grupos que puede tener el sistema.

Llame a la rutina KeQueryActiveProcessorCountEx para determinar el número de procesadores lógicos activos en un grupo determinado.

Windows 7 es la primera versión de Windows para admitir grupos de procesadores. En Windows 7, solo las versiones de 64 bits de Windows admiten varios grupos; Las versiones de 32 bits de Windows solo admiten un grupo. Un sistema multiprocesador que ejecuta una versión de 32 bits de Windows no puede contener más de 32 procesadores.

Requisitos

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

Consulte también

KeQueryActiveProcessorCountEx

KeQueryMaximumGroupCount