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 路徑中。