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

Статья
02/07/2025

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

Синтаксис

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. Панель управления позволяет пользователю выбрать, какие типы ошибок изображения (информационные, предупреждения или ошибки) записываются в журнал ошибок (см. записи реестра, не изменяемые).

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

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

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	stiusd.h (include Stiusd.h)

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