WIAS_TRACE マクロ (wiamdef.h)
WIAS_TRACE マクロは、診断メッセージを Wiatrace.log ファイルに書き込みます。
構文
void WIAS_TRACE(
x
);
パラメーター
x
HInst - DLL (ドライバー) へのハンドル。
format_string、... - 可変引数リストを指定します。これは、メッセージと任意の形式識別子を記述する ANSI 書式指定文字列で始まります。 省略記号 (...) は、出力する必要がある可変数の引数を指定します。 エラー テキストの先頭にメソッドまたは関数のフル ネームを付け、"class::method, error-text" の形式でメッセージを生成する必要があります。
戻り値
なし
解説
無料ビルドでトレースを有効にするには、ドライバーは WIA ヘッダーのいずれかを含める前に を追加 #define WIA_DEBUG して、WIA_DEBUG マクロを定義する必要があります。 トレースは、オペレーティング システムのチェック ビルドとデバッグ ビルドで既定で有効になっています。
マクロの使用方法の例を次に示します。
WIAS_TRACE((g_hInst,"WIA storage path = %ws",m_wszStoragePath));
このコード スニペットは 、GitHub の Windows イメージ取得 (WIA) ドライバー サンプルに含まれているWiadriver.cppから取得されました。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | wiamdef.h (Wiautil.h を含む) |