WIAS_ASSERT マクロ (wiautil.h)

WIAS_ASSERT マクロは、診断メッセージを Wiatrace.log ファイルに書き込みます。

構文

void WIAS_ASSERT(
   x,
   y
);

パラメーター

x

y

• 式 - 任意の論理式を指定します。

• HInst - 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 ヘッダーを含める前に行う必要があります。 アサートは、オペレーティング システムのチェック ビルドとデバッグ ビルドで既定で有効になっています。

要件

こちらもご覧ください

WIAS_ERROR

WIAS_HRESULT

WIAS_TRACE