ioInitializeIrp 函式 (wdm.h)

發行項
02/27/2024

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 。

如果驅動程式將 MDL 與其配置的 IRP 產生關聯，則驅動程式會負責在 IRP 完成時釋放 MDL。

中繼或最高層級驅動程式也可以呼叫 IoBuildDeviceIoControlRequest、 IoBuildAsynchronousFsdRequest 或 IoBuildSynchronousFsdRequest 來設定傳送至較低層級驅動程式的要求。只有最高層級的驅動程式可以呼叫 IoMakeAssociatedIrp。

規格需求

需求	值
最低支援的用戶端	從 Windows 2000 開始提供。
目標平台	Universal
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
DDI 合規性規則	HwStorPortProhibitedDIS (storport) 、 IoReuseIrp (wdm)