WIAS_ASSERT Makro (wiautil.h)
Das WIAS_ASSERT Makro schreibt eine Diagnosenachricht in die Wiatrace.log Datei.
void WIAS_ASSERT(
x,
y
);
x
y
Ausdruck – Gibt einen beliebigen logischen Ausdruck an.
HInst – Handle to the DLL (driver).
Nichts
Das WIAS_ASSERT Makro wird zum Debuggen von WIA-Treibern verwendet. Es wird verwendet, um zu testen, ob eine bestimmte Bedingung erfüllt ist. Wenn der Expression-Parameter TRUEausgewertet wird, führt dieses Makro nichts aus. Wenn Ausdruck als FALSE-ausgewertet wird, gibt das Makro eine Fehlerzeichenfolge in die Wiatrace.log Diagnoseprotokolldatei aus. Diese Fehlermeldung enthält den Namen und pfad zum aufrufenden Treiber und die Zeilennummer im Treiberquellcode, in dem das makro WIAS_ASSERT fehlgeschlagen ist.
Das WIAS_ASSERT Makro ist in Windows Vista und höheren Versionen des Betriebssystems verfügbar. Dieses Makro ist die empfohlene Methode zum Implementieren von WIA-Assertionen unter Windows Vista. WIAS_ASSERT ermöglicht das Schreiben von Fehlermeldungen in die Protokolldatei (Wiatrace.log). Die Wiatrace.log Datei ist nur in Windows Vista und höheren Versionen des Betriebssystems verfügbar. Das Hilfsprogramm, das zum Anzeigen des Inhalts dieser Protokolldatei verwendet wird, ist WiaTrcVw.exe.
Um Assertionen in kostenlosen Builds zu aktivieren, müssen Treiber das WIA_DEBUG Makro definieren, indem sie #define WIA_DEBUG zum Quellcode des Treibers hinzufügen; Dies muss erfolgen, bevor sie einen der WIA-Header einschließen. Assertionen sind standardmäßig in aktivierten und Debugbuilds des Betriebssystems aktiviert.
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | wiautil.h (include Wiautil.h) |