Funzione KeGetProcessorIndexFromNumber (ntifs.h)

La routine KeGetProcessorIndexFromNumber converte un numero di gruppo e un numero di processore relativo al gruppo in un indice del processore a livello di sistema.

Sintassi

ULONG KeGetProcessorIndexFromNumber(
  [in] PPROCESSOR_NUMBER ProcNumber
);

Parametri

[in] ProcNumber

Puntatore a una struttura PROCESSOR_NUMBER allocata dal chiamante che contiene un numero di gruppo e un numero di processore relativo al gruppo.

Valore restituito

KeGetProcessorIndexFromNumber restituisce un indice del processore a livello di sistema se la chiamata ha esito positivo. Se ProcNumber punta a un valore di PROCESSOR_NUMBER non valido, la routine restituisce INVALID_PROCESSOR_INDEX, definita nel file di intestazione Wdm.h.

Commenti

Questa routine accetta come input una struttura PROCESSOR_NUMBER che identifica un processore in base al numero di gruppo e al relativo numero di processore all'interno del gruppo. Il valore restituito è un indice del processore che identifica il processore nell'intero sistema multiprocessore.

Ad esempio, se un sistema multiprocessore contiene due gruppi e ogni gruppo contiene 64 processori logici, i numeri del processore in ogni gruppo sono compresi tra 0 e 63, ma gli indici del processore a livello di sistema sono compresi tra 0 e 127.

Per ottenere il numero totale di processori logici attivi nel sistema, chiamare la routine KeQueryActiveProcessorCountEx e impostare il parametro GroupNumber di questa routine su ALL_PROCESSOR_GROUPS.

La routine KeGetProcessorNumberFromIndex converte un indice processore a livello di sistema in un numero di gruppo e un numero di processore relativo al gruppo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7
Piattaforma di destinazione	Universale
Intestazione	ntifs.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Qualsiasi livello

Vedi anche

KeGetProcessorNumberFromIndex

KeQueryActiveProcessorCountEx

PROCESSOR_NUMBER