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 函式。 |
| 目標平台 | Universal |
| 標頭 | portcls.h (包括 Portcls.h) |
| 程式庫 | Portcls.lib |
| IRQL | <=DISPATCH_LEVEL |