WIAS_ERROR マクロ (wiautil.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) に書き込めるので、Windows Vista でエラー ログを実装するには、このマクロを使用することをお勧めします。 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));
このコード スニペットは 、GitHub の Windows イメージ取得 (WIA) ドライバー サンプルに含まれているWiadriver.cppから取得されました。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista 以降のバージョンのオペレーティング システムで使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | wiautil.h (Wiautil.h を含む) |