Função KeGetProcessorIndexFromNumber (ntifs.h)

  • Artigo

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

Confira também

KeGetProcessorNumberFromIndex

KeQueryActiveProcessorCountEx

PROCESSOR_NUMBER