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