共用方式為


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)

另請參閱

WIAS_ASSERT

WIAS_HRESULT

WIAS_TRACE