IoFreeIrp 函式 (wdm.h)
IoFreeIrp 例程會從呼叫端的 ioCompletion 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 開始提供。 |
目標平臺 | 普遍 |
標頭 | 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) |