IoSetTopLevelIrp function (wdm.h)
The IoSetTopLevelIrp routine sets the value of the TopLevelIrp field of the current thread.
Syntax
void IoSetTopLevelIrp(
[in, optional] PIRP Irp
);
Parameters
[in, optional] Irp
I/O request packet (IRP) pointer to be stored in the TopLevelIrp field of the current thread.
Return value
None
Remarks
IoSetTopLevelIrp sets the value of the TopLevelIrp field in the thread object for the current thread. This value can be NULL, a pointer to the current IRP, or an FSRTL flag. For more information about these values and what they mean, see the reference entry for IoGetTopLevelIrp.
Only file systems can call IoSetTopLevelIrp. File system filters and minifilters cannot safely call this routine, because doing so can cause deadlocks.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Universal |
| Header | wdm.h (include Rx.h, Wdm.h) |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |