Função KeGetProcessorIndexFromNumber (ntifs.h)
A rotina KeGetProcessorIndexFromNumber converte um número de grupo e um número de processador relativo ao grupo em um índice de processador em todo o sistema.
Sintaxe
ULONG KeGetProcessorIndexFromNumber(
[in] PPROCESSOR_NUMBER ProcNumber
);
Parâmetros
[in] ProcNumber
Um ponteiro para uma estrutura de PROCESSOR_NUMBER alocada pelo chamador que contém um número de grupo e um número de processador relativo ao grupo.
Retornar valor
KeGetProcessorIndexFromNumber retornará um índice de processador em todo o sistema se a chamada for bem-sucedida. Se ProcNumber apontar para um valor de PROCESSOR_NUMBER inválido, a rotina retornará INVALID_PROCESSOR_INDEX, que é definida no arquivo de cabeçalho Wdm.h.
Comentários
Essa rotina aceita como entrada uma estrutura PROCESSOR_NUMBER que identifica um processador por seu número de grupo e seu número de processador dentro do grupo. O valor retornado é um índice de processador que identifica o processador em todo o sistema multiprocessador.
Por exemplo, se um sistema multiprocessador contiver dois grupos e cada grupo contiver 64 processadores lógicos, os números de processador em cada grupo variam de 0 a 63, mas os índices de processador em todo o sistema variam de 0 a 127.
Para obter o número total de processadores lógicos ativos no sistema, chame a rotina KeQueryActiveProcessorCountEx e defina o parâmetro GroupNumber dessa rotina como ALL_PROCESSOR_GROUPS.
A rotina KeGetProcessorNumberFromIndex converte um índice de processador em todo o sistema em um número de grupo e um número de processador relativo ao grupo.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7 |
| Plataforma de Destino | Universal |
| Cabeçalho | ntifs.h (inclui Wdm.h, Ntddk.h, Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Qualquer nível |