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 |