(wdm.h) IoAllocateIrp 函式

IoAllocateIrp 例程會針對呼叫端下分層的每個驅動程式配置 I/O 堆棧位置數目，並選擇性地為呼叫端配置 I/O 堆棧位置。另請參閱 IoAllocateIrpEx。

語法

PIRP IoAllocateIrp(
  [in] CCHAR   StackSize,
  [in] BOOLEAN ChargeQuota
);

[in] StackSize

指定要配置給 IRP 的 I/O 堆疊位置數目。此值至少必須等於下一個較低驅動程式裝置物件的 StackSize ，但可以是大於此值的一個。呼叫驅動程式本身不需要在 IRP 中設定堆疊位置。

[in] ChargeQuota

將此設定為 TRUE 會導致針對 IRP 配置的記憶體，根據目前進程的配額來收費。中繼驅動程式應設定為 FALSE 。這隻能由在源自驅動程式配置另一個 IRP 之 I/O 要求的線程內容中呼叫的高階驅動程式設定為 TRUE 。

IoAllocateIrp 會傳回 IRP 的指標，此指標是從非分頁系統空間配置，如果無法配置 IRP，則傳回 NULL 。

IoAllocateIrp 例程不會將 IRP 與線程產生關聯。配置驅動程式必須釋放 IRP，而不是將它送回 I/O 管理員。

中繼或最高層級的驅動程式可以呼叫 IoAllocateIrp ，為傳送至較低層級驅動程式的要求建立IRP。這類驅動程式必須初始化 IRP，而且必須在它建立的 IRP 中設定其 IoCompletion 例程，以便在較低層級驅動程式完成要求處理時處置 IRP。

IoAllocateIrp 會自動初始化 IRP 的成員。請勿使用 IoInitializeIrp 先初始化 IRP，再使用。 (您可以使用 IoInitializeIrp 重複使用您已在特定特殊情況下使用的 IRP。如需詳細資訊，請參閱重複使用 IRP 。)

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

需求	值
最低支援的用戶端	從 Windows 2000 開始提供。
目標平台	Universal
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
DDI 合規性規則	ForwardedAtBadIrqlAllocate (wdm) 、 HwStorPortProhibitedDDIs (storport ) 、 IoAllocateComplete (wdm ) 、 IoAllocateForward (wdm) 、 IoAllocateFree (wdm) 、 IoAllocateIrpSign (wdm) 、 IoAllocateIrpSignalEventInCompletion2 (wdm) 、 IoAllocateIrpSignalEventInCompletion3 (wdm) 、 IoAllocateIrpSignalEventInCompletionTimeout (wdm) 、 IoFreeIrp (storport) 、 IoReuseIrp (wdm) 、 MarkPower (wdm) 、 MarkPowerDown (wdm) 、 MarkQueryRelations (wdm) 、 MarkStartDevice (wdm) 、 SpNoWait (storport) 、 StorPortStartIo (storport)