Поделиться через

Метод IWiaMiniDrv::d rvGetDeviceErrorStr (wiamindr_lh.h)

  • Статья

Метод IWiaMiniDrv::d rvGetDeviceErrorStr сопоставляет код ошибки со строкой Юникода, описывающей ошибку.

Синтаксис

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 . В ответ на этот вызов мини-driver должен использовать CoTaskMemAlloc для выделения памяти, которая будет содержать локализованную строку Юникода, соответствующую коду ошибки, переданной в мини-хранилище. Служба WIA (или приложение) освободит память. Вполне вероятно, что приложение отобразит строку, поэтому она должна быть осмысленной для конечного пользователя. Строка должна быть загружена из файла ресурсов, чтобы ее можно было локализовать на различных языках.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть wiamindr_lh.h (включая Wiamindr.h)