WIAS_ASSERT マクロ (wiamdef.h)
WIAS_ASSERT マクロは、 Wiatrace.log ファイルに 診断メッセージを書き込みます。
構文
void WIAS_ASSERT(
x,
y
);
パラメーター
x
任意の論理式を指定します。
y
DLL (ドライバー) へのハンドル。
戻り値
なし
解説
WIAS_ASSERT マクロは、WIA ドライバーをデバッグするために使用されます。 特定の条件が満たされていることをテストするために使用されます。 Expression パラメーターが TRUE と評価された場合、このマクロは何も行いません。 Expression がFALSE に評価された場合、マクロはエラー文字列をWiatrace.log診断ログ ファイルに出力します。 このエラー メッセージには、呼び出し元のドライバーの名前とパスと、WIAS_ASSERT マクロが失敗したドライバーのソース コードの行番号が含まれます。
WIAS_ASSERT マクロは、Windows Vista 以降のバージョンのオペレーティング システムで使用できます。 このマクロは、Windows Vista で WIA アサーションを実装するために推奨される方法です。 WIAS_ASSERTを使用すると、エラー メッセージをログ ファイルに書き込む (Wiatrace.log)。 Wiatrace.log ファイルは、Windows Vista 以降のバージョンのオペレーティング システムでのみ使用できます。 このログ ファイルの内容を表示するために使用されるユーティリティは WiaTrcVw.exe。
無料ビルドでアサートを有効にするには、ドライバーはドライバーのソース コードに を追加 #define WIA_DEBUG してWIA_DEBUG マクロを定義する必要があります。WIA ヘッダーを含める前にこれを行う必要があります。 アサートは、オペレーティング システムのチェック ビルドとデバッグ ビルドで既定で有効になっています。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | wiamdef.h (Wiautil.h を含む) |