IStiDeviceControl::WriteToErrorLog-Methode (stiusd.h)

Mit der IStiDeviceControl::WriteToErrorLog-Methode kann ein Benutzermodus-Minidriver eine Nachricht in das Stillbildfehlerprotokoll schreiben.

Syntax

HRESULT WriteToErrorLog(
  DWORD   dwMessageType,
  LPCWSTR pszMessage,
  DWORD   dwErrorCode
);

Parameter

dwMessageType

Vom Aufrufer bereitgestellter Konstantenwert, der den Nachrichtentyp darstellt. Die folgenden Werte werden in Sti.hdefiniert:

STI_TRACE_INFORMATION

STI_TRACE_WARNING

STI_TRACE_ERROR

pszMessage

Vom Aufrufer bereitgestellter Zeiger auf eine Nachrichtenzeichenfolge, die in die Protokolldatei geschrieben werden soll.

dwErrorCode

nicht verwendet.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Methode S_OK zurück. Andernfalls wird eine der STIERR-Präfixfehlercodes zurückgegeben, die in stierr.hdefiniert sind.

Bemerkungen

Die Fehlerprotokolldatei für das Stillbild heißt sti_trace.log und befindet sich im Windows-Verzeichnis. Über die Systemsteuerung kann ein Benutzer auswählen, welche immer noch Bildfehlertypen (Informations-, Warnungs- oder Fehlertypen) in das Fehlerprotokoll geschrieben werden (siehe nicht modifizierbare Registrierungseinträge).

Fehlermeldungen sollten für kritische Fehlerbedingungen reserviert werden, z. B. Gerätehardwarefehler. Informationsmeldungen können für Eigene Debuggingzwecke verwendet werden. Protokollierte Nachrichten sind für Benutzer nicht sichtbar, können aber von einem Supporttechniker verwendet werden, um die Probleme eines Benutzers zu debuggen.

Ein Stillbild-Minidriver empfängt ein IStiDeviceControl Schnittstellenzeiger als Eingabe für die IStiUSD::Initialize-Methode.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	stiusd.h (einschließlich Stiusd.h)