共用方式為


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)

另請參閱

WIAS_ASSERT

WIAS_HRESULT

WIAS_TRACE