共用方式為


IoFreeIrp 函式 (wdm.h)

IoFreeIrp 例程會從呼叫端的 ioCompletion IoCompletion 例程釋放呼叫端配置的 IRP。

語法

void IoFreeIrp(
  [in] PIRP Irp
);

參數

[in] Irp

要釋放之 IRP 的指標。

傳回值

沒有

言論

此例程是 IoAllocateIrpIoBuildAsynchronousFsdRequest的相互關係。 已發行的 IRP 必須由呼叫端配置。

此例程也會釋放配置給 ioMakeAssociatedIrp IRP,呼叫者在其中設定其 IoCompletion 例程,以傳回相關聯 IRP 的STATUS_MORE_PROCESSING_REQUIRED。

IoFreeIrp 不會釋放任何可能附加至 IRP 的 MDL。 釋放 IRP 的驅動程式必須明確釋放這些 MDL。 此外,如果 MDL 所描述的實體頁面已鎖定,驅動程式必須先解除鎖定頁面,才能釋放 MDL。 不過,驅動程式不需要明確取消對應這些頁面。 相反地,IoFreeMdl 會在釋放 MDL 時自動取消對應頁面。 如需示範如何釋放 MDL 鏈結的程式代碼範例,請參閱使用 MDL

要求

要求 價值
最低支援的用戶端 從 Windows 2000 開始提供。
目標平臺 普遍
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
連結庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
DDI 合規性規則 HwStorPortProhibitedDIS(storport)IoAllocateFree(wdm)IoBuildDeviceControlNoFree(wdm)IoBuildFsdFree(wdm)IoBuildSynchronousFsdRequestNoFree(wdm)IoFreeIrp(storport)

另請參閱

IoAllocateIrp

IoBuildAsynchronousFsdRequest

IoCompletion

IoMakeAssociatedIrp

IoSetCompletionRoutine