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 標頭之前新增 #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) 驅動程式範例。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | wiamdef.h (包括 Wiautil.h) |