pcForwardIrpSynchronous 函式 (portcls.h)
IRP 處理程式會使用 PcForwardIrpSynchronous 函式,將 #D086464A198B040599D3491D0F66912CA 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 函式。 |
目標平台 | Universal |
標頭 | portcls.h (包含 Portcls.h) |
程式庫 | Portcls.lib |
IRQL | PASSIVE_LEVEL |