IoFreeIrp 函式 (wdm.h)
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) |