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 標頭之前新增 #define WIA_DEBUG 來定義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) |