次の方法で共有


WIAS_ASSERT マクロ (wiamdef.h)

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

構文

void WIAS_ASSERT(
   x,
   y
);

パラメーター

x

論理式を指定します。

y

DLL (ドライバー) へのハンドル。

戻り値

何一つ

備考

WIAS_ASSERT マクロは、WIA ドライバーのデバッグに使用されます。 特定の条件が満たされていることをテストするために使用されます。 パラメーターが TRUE 評価された場合、このマクロは何も行いません。 が 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 ヘッダーを含む前に行う必要があります。 アサートは、オペレーティング システムのチェック ビルドとデバッグ ビルドで既定で有効になっています。

必要条件

要件 価値
ターゲット プラットフォーム デスクトップ
ヘッダー wiamdef.h (Wiautil.h を含む)

関連項目

WIAS_ERROR

WIAS_HRESULT

WIAS_TRACE