共用方式為

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]

指定要對應至字串的裝置錯誤值。 值為零表示未發生錯誤。

__MIDL__IWiaMiniDrv0040

lFlags [in]

保留的。

__MIDL__IWiaMiniDrv0041

plDevErr [out]

指向將接收此方法狀態代碼的記憶體位置。 如果這個方法傳回 S_OK，則儲存的值會是零。 否則，minidriver 特定的錯誤碼會儲存在此參數所指向的位置。

__MIDL__IWiaMiniDrv0042

ppszDevErrStr [out， optional]

指向將接收描述錯誤的字串位址的記憶體位置。

傳回值

成功時，方法應該會傳回 S_OK ，並清除 plDevErr 所指向的裝置錯誤值。 如果 minidriver 未完全實作這個方法，此方法應該會傳回 E_NOTIMPL。 如果 minidriver 無法辨識傳遞給這個方法的錯誤值，此方法應該會傳回 E_INVALIDARG。 如果方法失敗，它應該會傳回標準 COM 錯誤碼，並將minidriver特定的錯誤碼值放在 plDevErr 所指向的記憶體中。

備註

若要取得描述裝置特定 minidriver 產生的錯誤值的錯誤字串，WIA 服務會呼叫 IWiaMiniDrv：:d rvGetDeviceErrorStr 方法。 為了回應此呼叫，minidriver 應該使用 CoTaskMemAlloc 配置記憶體，其中包含對應至minidriver之錯誤碼的當地語系化 Unicode 字串。 WIA 服務 (或應用程式) 會釋放記憶體。 應用程式可能會顯示字串，因此對終端用戶應該有意義。 字串應該從資源檔載入，以便將其當地語系化成各種不同的語言。

規格需求

需求 值
目標平台 桌面
標頭 wiamindr_lh.h (包括 Wiamindr.h)