Función IoGetTopLevelIrp (wdm.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.
Observaciones
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 ningún recurso encima del sistema de archivos, IoGetTopLevelIrp devuelve NULL.
Si el sistema de archivos es el componente de nivel superior para el 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:
| Bandera | 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 para el subproceso actual y el subproceso actual está en una ruta de acceso de E/S rápida. |
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| encabezado de | wdm.h (incluya Ntifs.h, Wdm.h) |
| biblioteca de | NtosKrnl.lib |
| DLL de | NtosKrnl.exe |
| irQL | <= DISPATCH_LEVEL |