IStillImageW：：WriteToErrorLog 方法 (sti.h)

  • 项目

IStillImage：：WriteToErrorLog 方法将消息写入静态图像错误日志。

语法

HRESULT WriteToErrorLog(
       DWORD   dwMessageType,
  [in] LPCWSTR pszMessage
);

参数

dwMessageType

表示消息类型的调用方提供的常量值。 Sti.h 中定义了以下值：

STI_TRACE_INFORMATION

STI_TRACE_WARNING

STI_TRACE_ERROR

[in] pszMessage

调用方提供的指针，指向要写入日志文件的消息字符串。

返回值

如果操作成功，该方法将返回S_OK。 否则，它将返回 stierr.h 中定义的 STIERR 前缀错误代码之一。

注解

静态映像错误日志文件名为 sti_trace.log ，位于 Windows 目录中。 注册表值确定将哪些静态图像错误类型 (信息性、警告或错误) 写入错误日志， (请参阅 不可修改的注册表项) 。

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

在调用 IStillImage：：WriteToErrorLog 之前， IStillImage COM 接口的客户端必须调用 IStillImage：：StiCreateInstance 以获取 IStillImage 接口指针。

要求

要求 值
目标平台 桌面
标头 sti.h (包括 Sti.h)