WIAS_ERROR宏 (wiamdef.h)

WIAS_ERROR宏将诊断消息写入 Wiatrace.log 文件。

语法

void WIAS_ERROR(
   x
);

参数

x

  • HInst - DLL (驱动程序) 句柄。

  • format_string... - 指定变量参数列表,该列表以 ANSI 格式字符串开头,用于描述消息和任何格式标识符。 省略号 (...) 指定需要输出的可变数量的参数。 错误文本应以方法或函数的全名作为前缀,并采用“class::method, error-text”格式生成消息。

返回值

备注

此宏是实现错误日志记录的建议方法,因为与 WIAS_LERROR不同,WIA_ERROR允许将错误消息写入日志文件 (Wiatrace.log) 。 用于查看此日志文件内容的实用工具WiaTrcVw.exe。

若要在免费版本中启用跟踪,驱动程序必须通过在包括任何 WIA 标头之前添加 #define WIA_DEBUG 来定义WIA_DEBUG宏。 默认情况下,在选中和调试操作系统的版本中启用跟踪。

下面是如何使用宏的示例:

WIAS_ERROR((g_hInst, "Failed to read (%ws) entry under %ws section of device registry",REG_ENTRY_STORAGEPATH,REG_ENTRY_DEVICEDATA));

此代码片段取自 Wiadriver.cpp,该代码片段包含在 GitHub 上的 Windows 映像获取 (WIA) 驱动程序示例中。

要求

   
目标平台 桌面
Header wiamdef.h (包括 Wiautil.h)

另请参阅

WIAS_ASSERT

WIAS_HRESULT

WIAS_TRACE