通过

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.h中定义的 STIERR 前缀错误代码之一。

言论

静止图像错误日志文件命名为 sti_trace.log，位于 Windows 目录中。 控制面板允许用户选择将哪些静止图像错误类型（信息性、警告或错误）写入错误日志（请参阅 不可修改的注册表项）。

应为严重错误条件（例如设备硬件故障）保留错误消息。 信息性消息可用于你自己的调试目的。 记录的消息对用户不可见，但支持工程师可能会使用它们来帮助调试用户的问题。

静止图像微型驱动程序接收 IStiDeviceControl 接口指针作为其 IStiUSD：：Initialize 方法的输入。

要求

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