IoFreeIrp 函式 (wdm.h)

發行項
02/29/2024

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

語法

void IoFreeIrp(
  [in] PIRP Irp
);

參數

[in] Irp

要釋放之 IRP 的指標。

傳回值

無

備註

此例程是 IoAllocateIrp 或 IoBuildAsynchronousFsdRequest的相互轉換。已發行的 IRP 必須由呼叫端配置。

此例程也會釋放使用 IoMakeAssociatedIrp 配置的 IRP，呼叫端會設定其 IoCompletion 例程，以傳回相關聯 IRP 的STATUS_MORE_PROCESSING_REQUIRED。

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

規格需求

需求	值
最低支援的用戶端	從 Windows 2000 開始提供。
目標平台	Universal
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
DDI 合規性規則	HwStorPortProhibitedDDIs (storport) 、 IoAllocateFree (wdm) 、 IoBuildDeviceControlNoFree (wdm) 、 IoBuildFsdFree (wdm) 、 IoBuildSynchronousFsdRequestNoFree (wdm) 、 IoFreeIrp (storport)