Freigeben über


WIAS_ERROR Makro (wiautil.h)

Das WIAS_ERROR Makro schreibt eine Diagnosenachricht in die Wiatrace.log-Datei .

Syntax

void WIAS_ERROR(
   x
);

Parameter

x

  • HInst : Handle mit der DLL (Treiber).

  • 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 sein und die Nachricht im Format "class::method, error-text" generieren.

Rückgabewert

Keine

Bemerkungen

Dieses Makro ist die empfohlene Methode zum Implementieren der Fehlerprotokollierung unter Windows Vista, da WIA_ERROR im Gegensatz zu WIAS_LERROR das Schreiben von Fehlermeldungen in die Protokolldatei (Wiatrace.log) ermöglicht. 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 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 standardmäßig in aktivierten und Debugbuilds des Betriebssystems aktiviert.

Im Folgenden finden Sie ein Beispiel für die Verwendung des Makros:

WIAS_ERROR((g_hInst, "Failed to read (%ws) entry under %ws section of device registry",REG_ENTRY_STORAGEPATH,REG_ENTRY_DEVICEDATA));

Dieser Codeausschnitt stammt aus Wiadriver.cpp, der in den Windows Image Acquisition (WIA)-Treiberbeispielen auf GitHub enthalten ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und höheren Versionen des Betriebssystems.
Zielplattform Desktop
Kopfzeile wiautil.h (einschließlich Wiautil.h)

Weitere Informationen

WIAS_ASSERT

WIAS_HRESULT

WIAS_TRACE