IoMakeAssociatedIrp 函式 (ntddk.h)

發行項
02/29/2024

此例程保留供文件系統和文件系統篩選驅動程式使用。 IoMakeAssociatedIrp 例程會配置並初始化要與傳送至最高層級驅動程式之主要 IRP 相關聯的 IRP，讓呼叫端能夠分割原始要求，並將相關聯的 IRP 傳送至較低層級的驅動程式。

語法

PIRP IoMakeAssociatedIrp(
  [in] PIRP  Irp,
  [in] CCHAR StackSize
);

參數

[in] Irp

輸入至最高層級驅動程式分派例程之主要 IRP 的指標。

[in] StackSize

指定要配置給相關聯 IRP 的堆疊位置數目。此值必須至少等於下一個較低驅動程式裝置物件的 StackSize ，但相關聯的 IRP 可以有呼叫端的額外堆疊位置。

傳回值

IoMakeAssociatedIrp 會傳回相關聯 IRP 的指標，如果無法配置 IRP，則會傳回 NULL 指標。

備註

只有最高層級的驅動程式可以呼叫此例程。

只要呼叫端尚未在相關聯的 IRP 中設定 IoCompletion 例程，並從 其 IoCompletion 例程傳回STATUS_MORE_PROCESSING_REQUIRED，I/O 管理員就會在較低的驅動程式完成所有相關聯的 IRP 時自動完成主要 IRP。在這些情況下，當該驅動程序判斷所有相關聯的 IRP 都已完成時，呼叫端必須明確完成主要 IRP。

只有主要 IRP 與線程相關聯;相關聯的 IRP 不是。基於這個理由，I/O 管理員無法在線程結束時呼叫相關聯 IRP 的 Cancel 例程。當主要 IRP 的線程結束時，I/O 管理員會呼叫主要 IRP 的 Cancel 例程。 Cancel 例程負責追蹤所有相關聯的 IRP，並呼叫 IoCancelIrp 來取消它們。

規格需求

需求	值
最低支援的用戶端	從 Windows 2000 開始提供。
目標平台	Universal
標頭	ntddk.h (包含 Ntddk.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL