IoInitializeIrp 関数 (wdm.h)

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

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)