Función KeQueryMaximumProcessorCountEx (ntddk.h)

  • Artículo

La rutina KeQueryMaximumProcessorCountEx devuelve el número máximo de procesadores lógicos de un grupo especificado en un sistema multiprocesador.

Sintaxis

ULONG KeQueryMaximumProcessorCountEx(
  [in] USHORT GroupNumber
);

Parámetros

[in] GroupNumber

Especifica un número de grupo. Si un sistema de varios procesadores contiene n grupos, los grupos se numeran de 0 a n-1. Para obtener el número máximo de procesadores del sistema, establezca este parámetro en ALL_PROCESSOR_GROUPS, que se define en los archivos de encabezado Winnt.h y Ntdef.h.

Valor devuelto

KeQueryMaximumProcessorCountEx devuelve el número máximo de procesadores lógicos en el grupo especificado o en el sistema, como se indica en el valor del parámetro GroupNumber .

Comentarios

El valor devuelto por KeQueryMaximumProcessorCountEx permanece constante durante el tiempo de ejecución. Este valor depende de la configuración de hardware del sistema multiprocesador, pero nunca puede superar un límite fijo establecido por el sistema operativo Windows. Este límite es de 32 procesadores lógicos para versiones de 32 bits de Windows y procesadores lógicos de 64 bits para versiones de 64 bits de Windows.

En cambio, el valor devuelto por la rutina KeQueryActiveProcessorCountEx puede cambiar durante el tiempo de ejecución a medida que los procesadores se agregan dinámicamente al sistema.

Una rutina relacionada, KeQueryMaximumProcessorCount, devuelve un número máximo de procesadores, pero esta rutina, a diferencia de KeQueryMaximumProcessorCountEx, no acepta un número de grupo como parámetro de entrada. En Windows 7 y versiones posteriores del sistema operativo Windows, KeQueryMaximumProcessorCount devuelve el número máximo de procesadores lógicos 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 KeQueryMaximumProcessorCount 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 KeQueryMaximumProcessorCountEx en lugar de KeQueryMaximumProcessorCount.

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

KeQueryActiveProcessorCountEx

KeQueryMaximumProcessorCount