Función KeGetProcessorIndexFromNumber (wdm.h)

  • Artículo

La rutina KeGetProcessorIndexFromNumber convierte un número de grupo y un número de procesador relativo al grupo en un índice de procesador de todo el sistema.

Sintaxis

ULONG KeGetProcessorIndexFromNumber(
  [in] PPROCESSOR_NUMBER ProcNumber
);

Parámetros

[in] ProcNumber

Puntero a una estructura de PROCESSOR_NUMBER asignada por el autor de la llamada que contiene un número de grupo y un número de procesador relativo al grupo.

Valor devuelto

KeGetProcessorIndexFromNumber devuelve un índice de procesador de todo el sistema si la llamada se realiza correctamente. Si ProcNumber apunta a un valor de PROCESSOR_NUMBER no válido, la rutina devuelve INVALID_PROCESSOR_INDEX, que se define en el archivo de encabezado Wdm.h.

Comentarios

Esta rutina acepta como entrada una estructura PROCESSOR_NUMBER que identifica un procesador por su número de grupo y su número de procesador dentro del grupo. El valor devuelto es un índice de procesador que identifica el procesador en todo el sistema multiprocesador.

Por ejemplo, si un sistema multiprocesador contiene dos grupos y cada grupo contiene 64 procesadores lógicos, los números de procesador de cada grupo van de 0 a 63, pero los índices de procesador de todo el sistema van de 0 a 127.

Para obtener el número total de procesadores lógicos activos en el sistema, llame a la rutina KeQueryActiveProcessorCountEx y establezca el parámetro GroupNumber de esta rutina en ALL_PROCESSOR_GROUPS.

La rutina KeGetProcessorNumberFromIndex convierte un índice de procesador de todo el sistema en un número de grupo y un número de procesador relativo al grupo.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows 7 y versiones posteriores de Windows.
Plataforma de destino Universal
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL Cualquier nivel

Consulte también

KeGetProcessorNumberFromIndex

KeQueryActiveProcessorCountEx

PROCESSOR_NUMBER