Funzione KeGetProcessorIndexFromNumber (wdm.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 | Disponibile in Windows 7 e versioni successive di Windows. |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Qualsiasi livello |