IoInitializeIrp 関数 (wdm.h)
IoInitializeIrp ルーチンは、呼び出し元によって割り当てられた特定の IRP を初期化します。
構文
void IoInitializeIrp(
[in, out] PIRP Irp,
[in] USHORT PacketSize,
[in] CCHAR StackSize
);
パラメーター
[in, out] Irp
初期化する IRP へのポインター。
[in] PacketSize
IRP のサイズをバイト単位で指定します。
[in] StackSize
IRP のスタックの場所の数を指定します。
戻り値
なし
解説
ドライバーは 、IoInitializeIrp を使用して、生メモリとして割り当てられたドライバーの IRP を初期化します。 IoInitializeIrp を使用して、IoAllocateIrp によって割り当てられた IRP を初期化しないでください。 IoAllocateIrp は、IRP のメンバーを自動的に初期化します。
ドライバーは、 IoInitializeIrp を使用して、特定の状況でのみ再利用するために IRP を再初期化できます。 詳細については、「 IRP の再利用 」を参照してください。
ドライバーが割り当てられた IRP に MDL を関連付ける場合、ドライバーは、IRP が完了したときに MDL を解放します。
中間または最上位レベルのドライバーは、 IoBuildDeviceIoControlRequest、 IoBuildAsynchronousFsdRequest、または IoBuildSynchronousFsdRequest を呼び出して、下位レベルのドライバーに送信する要求を設定することもできます。 IoMakeAssociatedIrp を呼び出すことができるのは、最上位レベルのドライバーのみです。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 以降で使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| DDI コンプライアンス規則 | HwStorPortProhibitedDDIs(storport), IoReuseIrp(wdm) |