Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
This topic contains a list of the constants that are used for WIA IStream-based transfers.
Ces constantes sont divisées en trois sous-groupes :
Item type
Callback messages
Transfer flags
Item type
Le tableau suivant indique les bits de type d’élément WIA liés au transfert de données basé sur le flux.
| 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 | Notifie l’application de la progression du transfert. pWiaTransferParams->lPercentComplete contains the percent complete for this item and the page that is being transferred. |
| WIA_TRANSFER_MSG_END_OF_STREAM | Avertit l’application qu’il n’y a plus de données à transférer vers le flux de données actuel et que le flux peut être fermé. Un nouveau flux peut ensuite être demandé dans un transfert à plusieurs éléments ou multipage. Les pilotes n’envoient pas ce message manuellement. Le service WIA envoie automatiquement ce message lorsque le pilote demande le flux suivant. |
| WIA_TRANSFER_MSG_END_OF_TRANSFER | Reçu par l’application à la fin du transfert. Le pilote n’envoie pas ce message. 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 | Réservé par Microsoft pour une utilisation ultérieure. |
| WIA_TRANSFER_MSG_DEVICE_STATUS | Indique une erreur pendant le transfert (par exemple, une confiture de papier). pWiaTransferParams->hrErrorStatus contains the error status code. |
| WIA_TRANSFER_MSG_NEW_PAGE | Indique qu’une nouvelle page est transférée pendant un transfert multipage lorsqu’un format prenant en charge plusieurs pages d’un fichier (par exemple, TIFF multifichier) est utilisé. |
Transfer flags
The following table shows the flags that may be passed into IWiaMiniDrv::drvAcquireItemData.
| Name | Description |
|---|---|
| WIA_MINIDRV_TRANSFER_DOWNLOAD | Indique que le transfert est une opération de téléchargement en flux (autrement dit, un transfert de données d’un appareil vers une application). Les applications ne définissent pas ce bit directement. The WIA service sets this bit if the application calls IWiaTransfer::Download. |
| WIA_MINIDRV_TRANSFER_UPLOAD | Indique que le transfert est une opération de chargement en flux (autrement dit, un transfert de données d’une application vers un appareil). Les applications ne définissent pas ce bit directement. The WIA service sets this bit if the application calls IWiaTransfer::Upload. |
| WIA_MINIDRV_TRANSFER_ACQUIRE_CHILDREN | Indique que le pilote doit effectuer un transfert de dossier. Si cette valeur est appelée sur un élément de dossier, l’application demande de transférer les enfants de ce dossier. 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. |