共用方式為


PcCompleteIrp 函式 (portcls.h)

PcCompleteIrp 函式會完成先前標示為擱置的 IRP。

語法

PORTCLASSAPI NTSTATUS PcCompleteIrp(
  [in] PDEVICE_OBJECT pDeviceObject,
  [in] PIRP           pIrp,
  [in] NTSTATUS       ntStatus
);

參數

[in] pDeviceObject

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

[in] pIrp

要完成之 IRP 的指標

[in] ntStatus

指定已完成 IRP 的狀態。 請參閱頭檔 ntstatus.h 中定義的NTSTATUS值清單。

傳回值

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

言論

當 IRP 處理程式傳回STATUS_PENDING且 IRP 稍後必須完成時,會使用 pcCompleteIrp。 當配接器驅動程式完成 IRP 的所有處理時,它會呼叫 PcCompleteIrp 來完成 IRP。

IRP 處理程式不應該呼叫此函式。 適配卡驅動程式的 IRP 處理程式會改為呼叫 PcDispatchIrp,將 IRP 傳遞至 PortCls 系統驅動程式的 IRP 處理程式,以執行 IRP 的所有剩餘處理。

要求

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

另請參閱

DEVICE_OBJECT

IRP

IoCompleteRequest

PcDispatchIrp