Compartilhar via


Constantes de transferência wia

This topic contains a list of the constants that are used for WIA IStream-based transfers.

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

  • Item type

  • Callback messages

  • Transfer flags

Item type

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

Name Description
WiaItemTypeTransfer This WIA_IPA_ITEM_FLAGS bit should be set on all items that are capable of transferring data; that is, an application can initiate a download or upload on items that have this bit set.

Callback messages

The following table shows possible values for the lFlags parameter of IWiaTransferCallback::TransferCallback.

Name Description
WIA_TRANSFER_MSG_STATUS Notifica a aplicação do progresso da transferência.

pWiaTransferParams->lPercentComplete contains the percent complete for this item and the page that is being transferred.
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.

Um novo fluxo pode ser solicitado posteriormente 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 essa mensagem. The WIA service will send this message automatically after the transfer has ended (that is, the call to IWiaMiniDrv::drvAcquireItemData returns).
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 contains the error status code.
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.

Transfer flags

The following table shows the flags that may be passed into IWiaMiniDrv::drvAcquireItemData.

Name Description
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. The WIA service sets this bit if the application calls IWiaTransfer::Download.
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. The WIA service sets this bit if the application calls 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.

This value will be set if an application requests a folder transfer by setting the lFlags parameter of IWiaTransfer::Download to WIA_TRANSFER_ACQUIRE_CHILDREN and the driver has specified that it can transfer multiple children in one scan. If the driver cannot perform this type of transfer, the WIA service will make multiple calls into the driver and WIA_MINIDRV_TRANSFER_ACQUIRE_CHILDREN will not be set.