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


Метод IStiDeviceControl::WriteToErrorLog (stiusd.h)

Метод IStiDeviceControl::WriteToErrorLog позволяет мини-хранилище изображений в пользовательском режиме записывать сообщение в журнал ошибок неподвижного изображения.

Синтаксис

HRESULT WriteToErrorLog(
  DWORD   dwMessageType,
  LPCWSTR pszMessage,
  DWORD   dwErrorCode
);

Параметры

dwMessageType

Значение константы, предоставленное вызывающей стороны, представляющее тип сообщения. В Sti.h определены следующие значения:

STI_TRACE_INFORMATION

STI_TRACE_WARNING

STI_TRACE_ERROR

pszMessage

Предоставленный вызывающим элементом указатель на строку сообщения для записи в файл журнала.

dwErrorCode

Не используется.

Возвращаемое значение

Если операция выполнена успешно, метод возвращает S_OK. В противном случае возвращается один из кодов ошибок с префиксом STIERR, определенных в stierr.h.

Комментарии

Файл журнала ошибок неподвижного изображения называется sti_trace.log и находится в каталоге Windows. панель управления позволяет пользователю выбрать, какие типы ошибок изображения (информационные, предупреждения или ошибки) записываются в журнал ошибок (см. раздел Неизменяемые записи реестра).

Сообщения об ошибках следует зарезервировать для критических условий ошибок, таких как сбои оборудования устройства. Информационные сообщения можно использовать для собственных целей отладки. Зарегистрированные сообщения не видны пользователям, но они могут использоваться инженером службы поддержки для отладки проблем пользователя.

Мини-диск с неподвижным изображением получает указатель интерфейса IStiDeviceControl в качестве входных данных для метода IStiUSD::Initialize .

Требования

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