IWiaMiniDrv::d rvGetDeviceErrorStr メソッド (wiamindr_lh.h)

IWiaMiniDrv::d rvGetDeviceErrorStr メソッドは、エラーを記述する Unicode 文字列にエラー コードをマップします。

構文

HRESULT drvGetDeviceErrorStr(
  LONG     __MIDL__IWiaMiniDrv0039,
  LONG     __MIDL__IWiaMiniDrv0040,
  LPOLESTR *__MIDL__IWiaMiniDrv0041,
  LONG     *__MIDL__IWiaMiniDrv0042
);

パラメーター

__MIDL__IWiaMiniDrv0039

lDevErrVal [in]

文字列にマップするデバイス エラー値を指定します。 値 0 は、エラーが発生しなかったことを示します。

__MIDL__IWiaMiniDrv0040

lFlags [in]

予約済み。

__MIDL__IWiaMiniDrv0041

plDevErr [out]

このメソッドの状態コードを受け取るメモリの場所を指します。 このメソッドが S_OKを返す場合、格納される値は 0 になります。 それ以外の場合、ミニドライバー固有のエラー コードは、このパラメーターが指す場所に格納されます。

__MIDL__IWiaMiniDrv0042

ppszDevErrStr [out, optional]

エラーを説明する文字列のアドレスを受け取るメモリの場所を指します。

戻り値

成功した場合、メソッドは S_OK を返し、 plDevErr が指すデバイス エラー値をクリアする必要があります。 ミニドライバーがこのメソッドを完全に実装していない場合、メソッドは E_NOTIMPLを返す必要があります。 ミニドライバーがこのメソッドに渡されたエラー値を認識しない場合、メソッドは E_INVALIDARGを返す必要があります。 メソッドが失敗した場合は、標準の COM エラー コードを返し、 plDevErr が指すメモリにミニドライバー固有のエラー コード値を配置する必要があります。

注釈

デバイス固有のミニドライバーによって生成されたエラー値を記述するエラー文字列を取得するために、WIA サービスは IWiaMiniDrv::d rvGetDeviceErrorStr メソッドを呼び出します。 この呼び出しに応じて、ミニドライバーは CoTaskMemAlloc を使用して、ミニドライバーに渡されるエラー コードに対応するローカライズされた Unicode 文字列を含むメモリを割り当てる必要があります。 WIA サービス (またはアプリケーション) によってメモリが解放されます。 アプリケーションに文字列が表示される可能性があるため、エンド ユーザーにとって意味のあるものにする必要があります。 文字列は、さまざまな言語にローカライズできるように、リソース ファイルから読み込む必要があります。

要件

要件	値
対象プラットフォーム	デスクトップ
Header	wiamindr_lh.h (Wiamindr.h を含む)