IoGetTopLevelIrp 函式 (ntifs.h)
IoGetTopLevelIrp 例程會傳回目前線程的 TopLevelIrp 字段值。
Syntax
PIRP IoGetTopLevelIrp();
傳回值
IoGetTopLevelIrp 會傳回目前線程 的 TopLevelIrp 字段值。
備註
IoGetTopLevelIrp 可以傳回 NULL、任意文件系統特定值 (例如目前 IRP) 的指標，或下表所列的其中一個旗標。
如果目前的線程在文件系統上方沒有資源， IoGetTopLevelIrp 會傳回 NULL。
如果文件系統是目前線程的最上層元件， IoGetTopLevelIrp 會傳回目前 IRP 的指標。
如果文件系統以外的元件是目前線程的最上層元件， IoGetTopLevelIrp 會傳回下列其中一個旗標：
| 旗標 | 意義 |
|---|---|
| FSRTL_FSP_TOP_LEVEL_IRP | 這是遞歸呼叫。 |
| FSRTL_CACHE_TOP_LEVEL_IRP | 快取管理員是目前線程的最上層元件。 |
| FSRTL_MOD_WRITE_TOP_LEVEL_IRP | 修改的頁面寫入器是目前線程的最上層元件。 |
| FSRTL_FAST_IO_TOP_LEVEL_IRP | 快取管理員是目前線程的最上層元件，而目前的線程位於快速 I/O 路徑中。 |
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 標頭 | ntifs.h (包含 Ntifs.h、Wdm.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |