WIAS_ASSERT 宏 (wiamdef.h)

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

语法

void WIAS_ASSERT(
   x,
   y
);

参数

x

指定任何逻辑表达式。

y

DLL (驱动程序) 的句柄。

返回值

备注

WIAS_ASSERT 宏用于调试 WIA 驱动程序。 它用于测试是否满足特定条件。 如果 Expression 参数的计算结果为 TRUE,则此宏不执行任何工作。 如果 Expression 的计算结果为 FALSE,则宏会将错误字符串输出到 诊断日志文件Wiatrace.log 。 此错误消息将包含调用驱动程序的名称和路径,以及WIAS_ASSERT宏失败的驱动程序源代码中的行号。

WIAS_ASSERT 宏在 Windows Vista 和更高版本的操作系统中可用。 建议使用此宏在 Windows Vista 上实现 WIA 断言。 WIAS_ASSERT允许将错误消息写入日志文件 (Wiatrace.log) 。 Wiatrace.log 文件仅在 Windows Vista 及更高版本的操作系统中可用。 用于查看此日志文件内容的实用工具 WiaTrcVw.exe。

若要在免费版本中启用断言,驱动程序必须通过将 添加到 #define WIA_DEBUG 驱动程序的源代码来定义WIA_DEBUG宏;必须在包括任何 WIA 标头之前完成此操作。 默认情况下,在操作系统的已检查和调试版本中启用断言。

要求

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

另请参阅

WIAS_ERROR

WIAS_HRESULT

WIAS_TRACE