IoSetTopLevelIrp 函式 (ntifs.h)

IoSetTopLevelIrp 例程會設定目前線程的 TopLevelIrp 字段值。

語法

void IoSetTopLevelIrp(
  [in, optional] PIRP Irp
);

參數

[in, optional] Irp

I/O 要求封包 (IRP) 指標,以儲存在目前線程的 TopLevelIrp 字段中。

傳回值

備註

IoSetTopLevelIrp 會在目前線程的線程對象中設定 TopLevelIrp 欄位的值。 此值可以是 NULL、目前 IRP 的指標或 FSRTL 旗標。 如需這些值及其意義的詳細資訊,請參閱 IoGetTopLevelIrp的參考專案。

只有文件系統可以呼叫 IoSetTopLevelIrp。 文件系統篩選和迷你篩選無法安全地呼叫此例程,因為這樣做可能會導致死結。

規格需求

需求
目標平台 Universal
標頭 ntifs.h (包含 Rx.h、Wdm.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

另請參閱

IoGetTopLevelIrp