共用方式為


PcForwardIrpSynchronous 函式 (portcls.h)

IRP 處理程式會使用 PcForwardIrpSynchronous 函式,將即插即用 IRP 轉送至 實體裝置物件 (PDO)

語法

PORTCLASSAPI NTSTATUS PcForwardIrpSynchronous(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PIRP           Irp
);

參數

[in] DeviceObject

音訊裝置裝置物件的指標。 此參數必須指向類型為 DEVICE_OBJECT的系統結構。

[in] Irp

要轉送之 IRP 的指標

傳回值

PcForwardIrpSynchronous 如果呼叫成功,就會傳回STATUS_SUCCESS。 否則,它會傳回適當的錯誤碼。

言論

PcForwardIrpSynchronous 會導致下一個 PDO 接收 IRP 並封鎖,直到實體設備驅動器完成 IRP 為止。 此時,PcForwardIrpSynchronous 解除封鎖並返回呼叫端。 呼叫端 (IRP 處理程式) 最終應該會傳回 ,可能的狀態為 STATUS_PENDING。 一般而言,呼叫此函式的任何 IRP 處理程式都必須在傳回時指定動作IRP_ACTION_FINISH。 任何其他動作都會讓 IRP 第二次轉送至實體裝置。

當 IRP 處理程式傳回STATUS_PENDING且稍後必須完成 IRP 時,會使用 PcCompleteIrp 函式。

要求

要求 價值
最低支援的用戶端 PortCls 系統驅動程式會在 Microsoft Windows 98/Me 和 Windows 2000 和更新版本的作系統中實作 PcForwardIrpSynchronous 函式。
目標平臺 普遍
標頭 portcls.h (包括 Portcls.h)
連結庫 Portcls.lib
IRQL PASSIVE_LEVEL

另請參閱

DEVICE_OBJECT

IRP

PcCompleteIrp