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 方法的输入。

要求