Función IoGetTopLevelIrp (ntifs.h)

La rutina IoGetTopLevelIrp devuelve el valor del campo TopLevelIrp del subproceso actual.

Sintaxis

PIRP IoGetTopLevelIrp();

Valor devuelto

IoGetTopLevelIrp devuelve el valor del campo TopLevelIrp del subproceso actual.

Comentarios

IoGetTopLevelIrp puede devolver NULL, un valor arbitrario específico del sistema de archivos (como un puntero al IRP actual) o una de las marcas enumeradas en la tabla siguiente.

Si el subproceso actual no contiene recursos por encima del sistema de archivos, IoGetTopLevelIrp devuelve NULL.

Si el sistema de archivos es el componente de nivel superior del subproceso actual, IoGetTopLevelIrp devuelve un puntero al IRP actual.

Si un componente distinto del sistema de archivos es el componente de nivel superior para el subproceso actual, IoGetTopLevelIrp devuelve una de las marcas siguientes:

Marca	Significado
FSRTL_FSP_TOP_LEVEL_IRP	Se trata de una llamada recursiva.
FSRTL_CACHE_TOP_LEVEL_IRP	El administrador de caché es el componente de nivel superior del subproceso actual.
FSRTL_MOD_WRITE_TOP_LEVEL_IRP	El escritor de páginas modificado es el componente de nivel superior del subproceso actual.
FSRTL_FAST_IO_TOP_LEVEL_IRP	El administrador de caché es el componente de nivel superior del subproceso actual y el subproceso actual está en una ruta de acceso de E/S rápida.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Encabezado	ntifs.h (incluya Ntifs.h, Wdm.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL

Consulte también

IoSetTopLevelIrp