WIAS_ERROR 宏 (wiautil.h)
WIAS_ERROR 宏将诊断消息写入 Wiatrace.log 文件。
语法
void WIAS_ERROR(
x
);
参数
x
HInst - DLL (驱动程序) 的句柄。
format_string... - 指定变量参数列表，该列表以描述消息和任何格式标识符的 ANSI 格式字符串开头。 省略号 (...) 指定需要输出的可变数量的参数。 错误文本应以方法或函数的全名作为前缀，并生成格式为“class：：method， error-text”的消息。
返回值
无
备注
建议使用此宏在 Windows Vista 上实现错误日志记录，因为与 WIAS_LERROR不同，WIA_ERROR 允许将错误消息写入日志文件 (Wiatrace.log) 。 Wiatrace.log文件仅在 Windows Vista 和更高版本的操作系统中可用。 用于查看此日志文件内容的实用工具 WiaTrcVw.exe。
若要在免费版本中启用跟踪，驱动程序必须定义WIA_DEBUG宏，方法是在包括任何 WIA 标头之前添加 #define 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) 驱动程序示例中。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 Windows Vista 和更高版本的操作系统中可用。 |
| 目标平台 | 桌面 |
| 标头 | wiautil.h (包括 Wiautil.h) |