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