Función KeGetProcessorIndexFromNumber (ntifs.h)

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.

Observaciones

Esta rutina acepta como entrada una estructura de 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 de varios procesadores 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 KeGetProcessorNumberFromIn dex 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 Valor
cliente mínimo admitido Windows 7
de la plataforma de destino de Universal
encabezado de ntifs.h (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca de NtosKrnl.lib
DLL de NtosKrnl.exe
irQL Cualquier nivel

Consulte también

KeGetProcessorNumberFromIndex

KeQueryActiveProcessorCountEx

PROCESSOR_NUMBER