Función KeQueryActiveProcessorCount (wdm.h)

La rutina KeQueryActiveProcessorCount devuelve el número de procesadores activos actualmente.

Sintaxis

ULONG KeQueryActiveProcessorCount(
  [out, optional] PKAFFINITY ActiveProcessors
);

Parámetros

[out, optional] ActiveProcessors

Puntero a una variable con tipo KAFFINITY en la que la rutina escribe una máscara de bits que representa el conjunto de procesadores activos actualmente. En un entorno de adición activa, esta máscara puede cambiar durante el tiempo de ejecución. Este parámetro es opcional y se puede especificar como NULL si el autor de la llamada no requiere la máscara de procesadores activos.

Valor devuelto

KeQueryActiveProcessorCount devuelve el número de procesadores activos actualmente.

Comentarios

Un controlador de dispositivo llama a la rutina KeQueryActiveProcessorCount para recuperar el número de procesadores activos actualmente. Los controladores de dispositivo creados para Windows Vista y versiones posteriores del sistema operativo Windows no deben usar la variable de kernel KeNumberProcessors para este fin.

Los autores de llamadas no pueden suponer que la rutina KeQueryActiveProcessorCount asigna procesadores a bits en el valor KAFFINITY devuelto consecutivamente, o que la rutina devolverá la misma máscara de bits cada vez que se llama.

Los autores de llamadas también deben tener en cuenta que el valor devuelto por KeQueryActiveProcessorCount puede cambiar en tiempo de ejecución en las versiones de Windows que admiten la funcionalidad de CPU de adición activa.

Si es necesario, regístrese para recibir notificaciones de cambios en el número de procesadores llamando a la rutina KeRegisterProcessorChangeCallback .

Para consultar solo la máscara de afinidad sin obtener el número de procesadores activos, use KeQueryActiveProcessors.

Windows 7 y versiones posteriores de los grupos de procesadores de soporte técnico de Windows. Los controladores diseñados para controlar la información sobre los grupos de procesadores deben usar la rutina KeQueryActiveProcessorCountEx , que especifica un grupo de procesadores, en lugar de KeQueryActiveProcessorCount, que no. Sin embargo, la implementación de KeQueryActiveProcessorCount en Windows 7 y versiones posteriores de Windows proporciona compatibilidad con los controladores escritos para versiones anteriores de Windows, que no admiten grupos de procesadores. En esta implementación, KeQueryActiveProcessorCount devuelve el número de procesadores lógicos activos en el grupo 0 y escribe una máscara de afinidad en *ActiveProcessors que especifica el conjunto de procesadores lógicos activos en el grupo 0.

Requisitos

Consulte también

KeQueryActiveProcessorCountEx

KeQueryActiveProcessors

KeRegisterProcessorChangeCallback