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 |