Partilhar via


Cancelar uma transferência de dados

Importante

Este artigo contém informações que se aplicam a sistemas operacionais Windows obsoletos.

Aplicativos WIA e minidrivers WIA podem cancelar uma transferência de dados a qualquer momento. Um minidriver WIA pode determinar se um aplicativo cancelou a transferência de dados verificando o valor retornado pelo método IWiaMiniDrvCallBack::MiniDrvCallback . Se o método retornar S_FALSE, a transferência de dados foi cancelada. O minidriver WIA deve parar toda a atividade de aquisição e retornar a um estado ocioso. Está então pronto para a próxima transferência de dados.

Um minidriver WIA pode sinalizar que a transferência de dados foi cancelada retornando S_FALSE do método IWiaMiniDrv::d rvAcquireItemData . Alguns dispositivos têm um botão de cancelamento no hardware que pode abortar a transferência de dados. Nesses casos, o minidriver WIA deve retornar S_FALSE.

É possível cancelar uma verificação WIA sem declarar um erro e retornar S_FALSE. No entanto, isso só é possível no Windows XP e sistemas operacionais posteriores; não é possível no Windows Millennium Edition.

Todos os códigos de retorno recebidos do método IWiaMiniDrvCallBack::MiniDrvCallback devem ser retornados no método IWiaMiniDrv::d rvAcquireItemData . Se um aplicativo retorna um código de erro no método IWiaMiniDrvCallBack::MiniDrvCallback , o minidriver WIA deve parar a transferência de dados, retornar a um estado ocioso e, em seguida, retornar esse código de erro para o serviço WIA.