WIAS_ASSERT Makro (wiautil.h)
Das WIAS_ASSERT Makro schreibt eine Diagnosemeldung in die Wiatrace.log-Datei .
void WIAS_ASSERT(
x,
y
);
x
y
Ausdruck : Gibt einen beliebigen logischen Ausdruck an.
HInst : Handle mit der DLL (Treiber).
Keine
Das makro WIAS_ASSERT wird zum Debuggen von WIA-Treibern verwendet. Es wird verwendet, um zu testen, ob eine bestimmte Bedingung erfüllt ist. Wenn der Expression-Parameter auf TRUE ausgewertet wird, tut dieses Makro nichts. Wenn Expression auf FALSE ausgewertet wird, gibt das Makro eine Fehlerzeichenfolge in die Wiatrace.log Diagnoseprotokolldatei aus. Diese Fehlermeldung enthält den Namen und Pfad des aufrufenden Treibers sowie die Zeilennummer im Treiberquellcode, bei dem das WIAS_ASSERT Makro fehlgeschlagen ist.
Das makro WIAS_ASSERT ist in Windows Vista und höheren Versionen des Betriebssystems verfügbar. Dieses Makro ist die empfohlene Möglichkeit, WIA-Assertionen unter Windows Vista zu implementieren. 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 zum Anzeigen des Inhalts dieser Protokolldatei ist WiaTrcVw.exe.
Um Asserts in kostenlosen Builds zu aktivieren, müssen Treiber das WIA_DEBUG Makro definieren, indem sie dem Quellcode des Treibers hinzufügen #define WIA_DEBUG
. Dies muss vor dem Einschließen eines der WIA-Header erfolgen. Asserts sind standardmäßig in überprüften und Debugbuilds des Betriebssystems aktiviert.
Anforderung | Wert |
---|---|
Zielplattform | Desktop |
Kopfzeile | wiautil.h (einschließlich Wiautil.h) |