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));
このコード スニペットは 、GitHub の Windows イメージ取得 (WIA) ドライバー サンプルに含まれているWiadriver.cppから取得したものです。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | wiamdef.h (Wiautil.h を含む) |