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を返します。それ以外の場合は、適切なエラーコードを返します。

PCCompleteIrp は、IRP ハンドラーがSTATUS_PENDINGを返し、IRP が後で完了する必要がある場合に使用されます。アダプタードライバーは、IRP のすべての処理を完了すると、 PCCompleteIrp を呼び出して IRP を完了します。

IRP ハンドラーは、この関数を呼び出さないでください。アダプタードライバーの IRP ハンドラーは、代わりに PcDispatchIrp を呼び出して、IRP を PortCls システムドライバーの IRP ハンドラーに渡して、IRP の残りのすべての処理を実行します。

要件	値
サポートされている最小のクライアント	PortCls システムドライバーは、Microsoft Windows 98/Me および Windows 2000 以降のオペレーティングシステムで PcCompleteIrp 関数を実装します。
対象プラットフォーム	ユニバーサル
Header	portcls.h (Portcls.h を含む)
Library	Portcls.lib
IRQL	<=DISPATCH_LEVEL