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.