Funzione IoGetTopLevelIrp (ntifs.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	ntifs.h (include Ntifs.h, Wdm.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL

Vedi anche

IoSetTopLevelIrp