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. |