Compartilhar via


Constantes de transferência wia

Este tópico contém uma lista das constantes usadas para transferências baseadas em WIA IStream.

Essas constantes são divididas em três subgrupos:

  • Tipo de item

  • Mensagens de retorno de chamada

  • Sinalizadores de transferência

Tipo de item

A tabela a seguir mostra quais bits de tipo de item WIA estão relacionados à transferência de dados baseada em fluxo.

Nome Descrição
WiaItemTypeTransfer Esse WIA_IPA_ITEM_FLAGS bit deve ser definido em todos os itens capazes de transferir dados; ou seja, um aplicativo pode iniciar um download ou upload em itens que têm esse bit definido.

Mensagens de retorno de chamada

A tabela a seguir mostra valores possíveis para o parâmetro lFlags de IWiaTransferCallback::TransferCallback.

Nome Descrição
WIA_TRANSFER_MSG_STATUS Notifica a aplicação do progresso da transferência.

pWiaTransferParams-lPercentComplete> contém a porcentagem concluída para este item e a página que está sendo transferida.
WIA_TRANSFER_MSG_END_OF_STREAM Notifica o aplicativo de que não há mais dados a serem transferidos para o fluxo de dados atual e que o fluxo pode ser fechado.

Posteriormente, um novo fluxo pode ser solicitado em uma transferência de vários itens ou várias páginas.

Os drivers não enviam essa mensagem manualmente. O serviço WIA enviará automaticamente essa mensagem quando o driver solicitar o próximo fluxo.
WIA_TRANSFER_MSG_END_OF_TRANSFER Recebido pelo aplicativo no final da transferência.

O driver não envia esta mensagem. O serviço WIA enviará essa mensagem automaticamente após o término da transferência (ou seja, a chamada para IWiaMiniDrv::d rvAcquireItemData retorna).
WIA_TRANSFER_MSG_ERROR Reservado pela Microsoft para uso futuro.
WIA_TRANSFER_MSG_DEVICE_STATUS Indica um erro durante a transferência (por exemplo, um congestionamento de papel).

pWiaTransferParams-hrErrorStatus> contém o erro status código.
WIA_TRANSFER_MSG_NEW_PAGE Indica que uma nova página está sendo transferida durante uma transferência de várias páginas quando um formato que dá suporte a várias páginas em um arquivo (como TIFF de vários arquivos) está sendo usado.

Sinalizadores de transferência

A tabela a seguir mostra os sinalizadores que podem ser passados para IWiaMiniDrv::d rvAcquireItemData.

Nome Descrição
WIA_MINIDRV_TRANSFER_DOWNLOAD Indica que a transferência é uma operação de download baseada em fluxo (ou seja, uma transferência de dados de um dispositivo para um aplicativo).

Os aplicativos não definem esse bit diretamente. O serviço WIA define esse bit se o aplicativo chamar IWiaTransfer::D ownload.
WIA_MINIDRV_TRANSFER_UPLOAD Indica que a transferência é uma operação de upload baseada em fluxo (ou seja, uma transferência de dados de um aplicativo para um dispositivo).

Os aplicativos não definem esse bit diretamente. O serviço WIA define esse bit se o aplicativo chamar IWiaTransfer::Upload.
WIA_MINIDRV_TRANSFER_ACQUIRE_CHILDREN Indica que o driver deve executar uma transferência de pasta. Se esse valor for chamado em um item de pasta, o aplicativo solicitará a transferência dos filhos dessa pasta.

Esse valor será definido se um aplicativo solicitar uma transferência de pasta definindo o parâmetro lFlags de IWiaTransfer::D ownload como WIA_TRANSFER_ACQUIRE_CHILDREN e o driver tiver especificado que ele pode transferir vários filhos em uma verificação. Se o driver não puder executar esse tipo de transferência, o serviço WIA fará várias chamadas para o driver e WIA_MINIDRV_TRANSFER_ACQUIRE_CHILDREN não será definido.