IoFreeIrp 関数 (wdm.h)

[アーティクル]
08/08/2023

IoFreeIrp ルーチンは、呼び出し元の IoCompletion ルーチンから呼び出し元によって割り当てられた IRP を解放します。

構文

void IoFreeIrp(
  [in] PIRP Irp
);

パラメーター

[in] Irp

解放される IRP へのポインター。

戻り値

なし

解説

このルーチンは、 IoAllocateIrp または IoBuildAsynchronousFsdRequest に対する逆数です。解放された IRP は、呼び出し元によって割り当てられている必要があります。

このルーチンは、呼び出し元が関連付けられている IRP のSTATUS_MORE_PROCESSING_REQUIREDを返す IoCompletion ルーチンを設定する IoMakeAssociatedIrp で割り当てられた IRP も解放します。

IoFreeIrp では、IRP にアタッチされている可能性のある MDL は解放されません。 IRP を解放するドライバーは、これらの MDL を明示的に解放する必要があります。さらに、MDL で記述されている物理ページがロックされている場合、ドライバーは MDL を解放する前にページのロックを解除する必要があります。ただし、ドライバーはこれらのページのマップを明示的に解除する必要はありません。代わりに、 IoFreeMdl は MDL を解放するとページのマップを自動的に解除します。 MDL チェーンを解放する方法を示すコード例については、「 MDL の使用」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 以降で使用できます。
対象プラットフォーム	ユニバーサル
Header	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
DDI コンプライアンス規則	HwStorPortProhibitedDDIs(storport), IoAllocateFree(wdm), IoBuildDeviceControlNoFree(wdm), IoBuildFsdFree(wdm), IoBuildSynchronousFsdRequestNoFree(wdm), IoFreeIrp(storport)