通过

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，则存储的值将为零。 否则，微型驱动程序特定的错误代码将存储在此参数指向的位置。

__MIDL__IWiaMiniDrv0042

ppszDevErrStr [out， optional]

指向将接收描述错误的字符串地址的内存位置。

返回值

成功后，该方法应返回 S_OK 并清除 plDevErr指向的设备错误值。 如果微型驱动程序未完全实现此方法，该方法应返回 E_NOTIMPL。 如果微型驱动程序无法识别传递给此方法的错误值，该方法应返回 E_INVALIDARG。 如果方法失败，它应返回标准 COM 错误代码，并将特定于微型驱动程序的错误代码值放在 plDevErr指向的内存中。

言论

若要获取描述设备特定的微型驱动程序生成的错误值的错误字符串，WIA 服务调用 IWiaMiniDrv：:d rvGetDeviceErrorStr 方法。 为了响应此调用，微型驱动程序应使用 CoTaskMemAlloc 来分配内存，该内存将包含与传递给微型驱动程序的错误代码对应的本地化 Unicode 字符串。 WIA 服务（或应用程序）将释放内存。 应用程序可能会显示字符串，因此它应该对最终用户有意义。 字符串应从资源文件加载，以便它可以本地化为多种语言。

要求

要求 价值
目标平台 桌面
标头 wiamindr_lh.h （包括 Wiamindr.h）