KsForwardIrp 函式 (ks.h)

KsForwardIrp 函式會在初始化下一個堆疊位置並設定檔案物件之後，將 IRP 轉送至指定的驅動程式。

語法

KSDDKAPI NTSTATUS KsForwardIrp(
  [in] PIRP         Irp,
  [in] PFILE_OBJECT FileObject,
  [in] BOOLEAN      ReuseStackLocation
);

[in] Irp

指定正轉送至指定驅動程式的 IRP。

[in] FileObject

指定要使用初始化下一個堆疊的檔案物件。

[in] ReuseStackLocation

指定新的堆疊位置。

KsForwardIrp 函式會傳回 IoCallDriver 的結果，如果沒有可用的堆疊深度，則會傳回無效的狀態。

當目前堆疊參數複製到下一個堆疊位置時，只有在轉送 IRP 的 FileObject 參數變更時，才使用 KsForwardIrp 函式。函式會先確認有新的堆疊位置要複製到，然後再嘗試複製。如果沒有新的堆疊位置，IRP 就會完成STATUS_INVALID_DEVICE_REQUEST。