IoForwardIrpSynchronously 函式 (wdm.h)
IoForwardIrpSynchronously 例程會將 IRP 傳送至指定的驅動程式,並等候該驅動程式完成 IRP。
語法
BOOLEAN IoForwardIrpSynchronously(
[in] PDEVICE_OBJECT DeviceObject,
[in] PIRP Irp
);
參數
[in] DeviceObject
指定傳送 IRP 之驅動程式的裝置物件。
[in] Irp
指定要傳送的 IRP。
傳回值
如果成功傳送 IRP,IoForwardIrpSynchronously 會傳 回 TRUE。 否則,它會 FALSE傳回 。
言論
使用 IoForwardIrpSynchronously 例程,同步將目前的 IRP 轉送至堆疊中的下一個驅動程式。 (若要以異步方式轉送 IRP,請使用 IoCopyCurrentIrpStackLocationToNext、IoCallDriver,以及 IoSetCompletionRoutine 例程。
IoForwardIrpSynchronously 例程會將目前的堆疊位置複製到下一個堆疊位置。 然後,該堆疊位置會由 DeviceObject中指定的驅動程式作為目前的堆疊位置。 如果沒有下一個堆疊位置可用,例程會傳回 FALSE。 如果例程傳回 TRUE,則 IRP 已傳送至指定的驅動程式,且該驅動程式已完成此 IRP 的處理。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 適用於 Windows XP 和更新版本的 Windows。 |
目標平臺 | 普遍 |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |
DDI 合規性規則 | PnpIrpCompletion(wdm) |