Freigeben über


WIA-Treiberfehlerberichterstattung für Windows Me und Windows XP

Ein WIA-Minidriver kann erweiterte Fehlerinformationen in Zeichenfolgenform an die WIA-Anwendung melden. Nachdem ein HRESULT-Fehlercode empfangen wurde, kann eine WIA-Anwendung die IWiaItemExtras::GetExtendedErrorInfo-Methode (beschrieben in der Microsoft Windows SDK-Dokumentation) für eine benutzerlesbare Zeichenfolge aufrufen, die die Details eines Fehlers beschreibt. Die von dieser Methode gemeldete Zeichenfolge sollte in mehrere Sprachen lokalisiert werden.

Ein WIA-Minitreiber sollte die folgenden Methoden implementieren, um die Fehlerberichterstattung auszuführen:

IStiUSD::GetLastError − Der WIA-Dienst ruft diese Methode auf, um den gerätespezifischen Fehlercode für die zuletzt fehlgeschlagene Aktion abzurufen.

IStiUSD::GetLastErrorInfo − Der WIA-Dienst ruft diese Methode auf, um erweiterte Informationen über den Fehlercode abzurufen, der vom IStiUSD::GetLastError-Methodenaufruf zurückgegeben wird.

IWiaMiniDrv::d rvGetDeviceErrorStr − Der WIA-Dienst ruft diese Methode auf, um alle anzeigebaren Zeichenfolgen abzurufen, die den Fehler detailliert beschreiben, oder Anweisungen für den Endbenutzer, wie nach dem Fehler fortzufahren. Die IWiaItemExtras::GetExtendedErrorInfo-Methode gibt die von dieser Methode abgerufene Fehlerzeichenfolge zurück.

Der WIA-Dienst fragt nach Fehlerinformationen, wenn eine der IWiaMiniDrv-COM-Schnittstellenmethoden fehlschlägt.