Compartilhar via

Cancelar uma transferência de dados

  • Artigo

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 interromper todas as atividades de aquisição e retornar a um estado ocioso. Em seguida, ele está 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 cancelar no hardware que pode anular 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 em 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 retornar um código de erro no método IWiaMiniDrvCallBack::MiniDrvCallback , o minidriver WIA deverá interromper a transferência de dados, retornar a um estado ocioso e, em seguida, retornar esse código de erro para o serviço WIA.