Compartilhar via


Relatório de erros do driver WIA para Windows Me e Windows XP

Um minidriver WIA tem a capacidade de relatar informações de erro estendidas para o aplicativo WIA em formato de cadeia de caracteres. Depois de receber um código de erro HRESULT, um aplicativo WIA pode chamar o método IWiaItemExtras::GetExtendedErrorInfo (descrito na documentação do SDK do Microsoft Windows) para uma cadeia de caracteres legível pelo usuário que descreve os detalhes de um erro. A cadeia de caracteres relatada por esse método deve ser localizada em vários idiomas.

Um minidriver WIA deve implementar os seguintes métodos para executar relatórios de erros:

IStiUSD::GetLastError – o serviço WIA chama esse método para recuperar o código de erro específico do dispositivo para a ação com falha recente.

IStiUSD::GetLastErrorInfo – o serviço WIA chama esse método para recuperar informações estendidas sobre o código de erro retornado da chamada de método IStiUSD::GetLastError .

IWiaMiniDrv::d rvGetDeviceErrorStr – O serviço WIA chama esse método para recuperar todas as cadeias de caracteres que descrevem o erro em detalhes ou instruções para o usuário final sobre como proceder após o erro. O método IWiaItemExtras::GetExtendedErrorInfo retorna a cadeia de caracteres de erro que este método recuperou.

O serviço WIA solicita informações de erro se algum dos métodos da interface COM IWiaMiniDrv falhar.