IStiDeviceControl::WriteToErrorLog-Methode (stiusd.h)
Die IStiDeviceControl::WriteToErrorLog-Methode ermöglicht es einem Benutzermodus-Minidriver für Nochbilder, eine Nachricht in das Fehlerprotokoll für das Standbild zu schreiben.
HRESULT WriteToErrorLog(
DWORD dwMessageType,
LPCWSTR pszMessage,
DWORD dwErrorCode
);
dwMessageType
Vom Aufrufer bereitgestellter konstanter Wert, der den Nachrichtentyp darstellt. Die folgenden Werte werden in Sti.h definiert:
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.
Wenn der Vorgang erfolgreich ist, gibt die Methode S_OK zurück. Andernfalls wird einer der in stierr.h definierten Fehlercodes mit STIERR-Präfix zurückgegeben.
Die Fehlerprotokolldatei für das Standbild heißt sti_trace.log und befindet sich im Windows-Verzeichnis. Systemsteuerung ermöglicht es einem Benutzer auszuwählen, welche Fehlertypen (Information, Warnung oder Fehler) in das Fehlerprotokoll geschrieben werden (siehe Nicht veränderbare Registrierungseinträge).
Fehlermeldungen sollten für kritische Fehlerbedingungen reserviert werden, z. B. Gerätehardwarefehler. Informationsmeldungen können für Ihre eigenen Debugzwecke verwendet werden. Protokollierte Nachrichten sind für Benutzer nicht sichtbar, aber sie können von einem Supporttechniker verwendet werden, um die Probleme eines Benutzers zu debuggen.
Ein Standbild-Minidriver empfängt einen IStiDeviceControl-Schnittstellenzeiger als Eingabe auf seine IStiUSD::Initialize-Methode .
Anforderung | Wert |
---|---|
Zielplattform | Desktop |
Kopfzeile | stiusd.h (einschließlich Stiusd.h) |