WIAS_ERROR マクロ (wiamdef.h)
WIAS_ERROR マクロは、Wiatrace.log ファイルに診断メッセージを書き込みます。
構文
void WIAS_ERROR(
x
);
パラメーター
x
HInst - DLL (ドライバー) へのハンドル。
format_string、... - 可変引数リストを指定します。これは、メッセージと任意の形式識別子を記述する ANSI 書式指定文字列で始まります。 省略記号 (...) は、出力する必要がある可変数の引数を指定します。 エラー テキストには、メソッドまたは関数の完全な名前のプレフィックスを付け、"class::method, error-text" の形式でメッセージを生成する必要があります。
戻り値
何一つ
備考
このマクロは、WIAS_LERRORとは異なり、エラー メッセージをログ ファイル (Wiatrace.log) に書き込むことがWIA_ERRORできるため、エラー ログを実装する推奨される方法です。 このログ ファイルの内容を表示するために使用するユーティリティは 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から取得したものです。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | wiamdef.h (Wiautil.h を含む) |