Funzione IoGetTopLevelIrp (wdm.h)
La routine IoGetTopLevelIrp restituisce il valore del campo TopLevelIrp del thread corrente.
Sintassi
PIRP IoGetTopLevelIrp();
Valore restituito
IoGetTopLevelIrp restituisce il valore del campo TopLevelIrp del thread corrente.
Commenti
IoGetTopLevelIrp può restituire NULL, un valore specifico del file system arbitrario (ad esempio un puntatore all'IRP corrente) o uno dei flag elencati nella tabella seguente.
Se il thread corrente non contiene risorse al di sopra del file system, IoGetTopLevelIrp restituisce NULL.
Se il file system è il componente di primo livello per il thread corrente, IoGetTopLevelIrp restituisce un puntatore all'IRP corrente.
Se un componente diverso dal file system è il componente di primo livello per il thread corrente, IoGetTopLevelIrp restituisce uno dei flag seguenti:
| Contrassegno | Significato |
|---|---|
| FSRTL_FSP_TOP_LEVEL_IRP | Si tratta di una chiamata ricorsiva. |
| FSRTL_CACHE_TOP_LEVEL_IRP | Gestione cache è il componente di primo livello per il thread corrente. |
| FSRTL_MOD_WRITE_TOP_LEVEL_IRP | Il writer di pagine modificato è il componente di primo livello per il thread corrente. |
| FSRTL_FAST_IO_TOP_LEVEL_IRP | Gestione cache è il componente di primo livello per il thread corrente e il thread corrente si trova in un percorso di I/O veloce. |
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Ntifs.h, Wdm.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |