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_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) 驱动程序示例中。

要求

要求
目标平台 桌面
标头 wiamdef.h (包括 Wiautil.h)

另请参阅

WIAS_ASSERT

WIAS_HRESULT

WIAS_TRACE