WIAS_TRACE Makro (wiautil.h)
Das makro WIAS_TRACE schreibt eine Diagnosenachricht in dieWiatrace.log datei.
Syntax
void WIAS_TRACE(
x
);
Parameter
x
HInst : Handle to the DLL (driver).
Format_string... – Gibt eine Variablenargumentliste an, die mit einer ANSI-Formatzeichenfolge beginnt, die die Nachricht und alle Formatbezeichner beschreibt. Die Auslassungspunkte (...) gibt eine variable Anzahl von Argumenten an, die ausgegeben werden müssen. Dem Fehlertext sollte der vollständige Name der Methode oder Funktion vorangestellt werden und die Meldung im Format "class::method, error-text" generiert werden.
Rückgabewert
Keine
Bemerkungen
Um die Ablaufverfolgung in kostenlosen Builds zu aktivieren, müssen Treiber das WIA_DEBUG Makro definieren, indem sie hinzufügen, #define WIA_DEBUG bevor sie einen der WIA-Header einschließen. Die Ablaufverfolgung ist in überprüften und Debugbuilds des Betriebssystems standardmäßig aktiviert.
Im Folgenden finden Sie ein Beispiel für die Verwendung des Makros:
WIAS_TRACE((g_hInst,"WIA storage path = %ws",m_wszStoragePath));
Dieser Codeausschnitt stammt ausWiadriver.cpp, der im WDK enthalten ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | wiautil.h (wiautil.h einschließen) |