Constantes de transfert WIA

Cette rubrique contient une liste des constantes utilisées pour les transferts basés sur WIA IStream.

Ces constantes sont divisées en trois sous-groupes :

Type d'élément

Le tableau suivant montre quels bits de type d’élément WIA sont liés au transfert de données basé sur le flux.

Nom	Description
WiaItemTypeTransfer	Ce WIA_IPA_ITEM_FLAGS bit doit être défini sur tous les éléments capables de transférer des données ; autrement dit, une application peut lancer un téléchargement ou un chargement sur les éléments qui ont ce bit défini.

Le tableau suivant montre les valeurs possibles pour le paramètre lFlags de IWiaTransferCallback ::TransferCallback.

Nom	Description
WIA_TRANSFER_MSG_STATUS	Notifie l’application de la progression du transfert. pWiaTransferParams-lPercentComplete> contient le pourcentage complet de cet élément et la page en cours de transfert.
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 par la suite être demandé dans un transfert multi-é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. Le service WIA envoie automatiquement ce message une fois le transfert terminé (autrement dit, l’appel à IWiaMiniDrv ::d rvAcquireItemData retourne).
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, un bourrage de papier). pWiaTransferParams-hrErrorStatus> contient l’erreur status code.
WIA_TRANSFER_MSG_NEW_PAGE	Indique qu’une nouvelle page est transférée lors d’un transfert multipage lorsqu’un format prenant en charge plusieurs pages dans un fichier (par exemple, TIFF multifichier) est utilisé.

Le tableau suivant montre les indicateurs qui peuvent être passés dans IWiaMiniDrv ::d rvAcquireItemData.

Nom	Description
WIA_MINIDRV_TRANSFER_DOWNLOAD	Indique que le transfert est une opération de téléchargement basée sur un flux (autrement dit, un transfert de données d’un appareil vers une application). Les applications ne définissent pas ce bit directement. Le service WIA définit ce bit si l’application appelle IWiaTransfer ::D ownload.
WIA_MINIDRV_TRANSFER_UPLOAD	Indique que le transfert est une opération de chargement basée sur un flux (autrement dit, un transfert de données d’une application vers un appareil). Les applications ne définissent pas ce bit directement. Le service WIA définit ce bit si l’application appelle IWiaTransfer ::Upload.
WIA_MINIDRV_TRANSFER_ACQUIRE_CHILDREN	Indique que le pilote doit effectuer un transfert de dossiers. Si cette valeur est appelée sur un élément de dossier, l’application demande de transférer les enfants de ce dossier. Cette valeur est définie si une application demande un transfert de dossier en définissant le paramètre lFlags de IWiaTransfer ::D ownload sur WIA_TRANSFER_ACQUIRE_CHILDREN et que le pilote a spécifié qu’il peut transférer plusieurs enfants en une seule analyse. Si le pilote ne peut pas effectuer ce type de transfert, le service WIA effectue plusieurs appels dans le pilote et WIA_MINIDRV_TRANSFER_ACQUIRE_CHILDREN ne sera pas défini.