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 标头。 默认情况下,在已选中和调试操作系统的生成中,会启用断言。

要求

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

另请参阅

WIAS_ERROR

WIAS_HRESULT

WIAS_TRACE