Méthode IWiaDataTransfer::idtGetData (wia_xp.h)

La méthode IWiaDataTransfer::idtGetData récupère les fichiers complets à partir d’un appareil d’acquisition d’images Windows (WIA).

Syntaxe

HRESULT idtGetData(
  [in, out] LPSTGMEDIUM      pMedium,
  [in]      IWiaDataCallback *pIWiaDataCallback
);

Paramètres

[in, out] pMedium

Type : LPSTGMEDIUM

Pointeur vers la structure STGMEDIUM .

[in] pIWiaDataCallback

Type : IWiaDataCallback*

Pointeur vers l’interface IWiaDataCallback .

Valeur retournée

Type : HRESULT

Cette méthode peut retourner l’une des valeurs suivantes :

Cette méthode retourne une valeur spécifiée dans codes d’erreur, ou une erreur COM standard si elle échoue pour une raison autre que celles spécifiées dans le tableau précédent.

Remarques

À la plupart des égards, cette méthode fonctionne de manière identique à la méthode IDataObject::GetData . La principale différence est que IWiaDataTransfer::idtGetData fournit un paramètre supplémentaire pour un pointeur vers l’interface IWiaDataCallback . Les applications utilisent ce paramètre facultatif pour obtenir status notifications pendant le transfert de données. Si aucune notification status n’est nécessaire, elle doit être définie sur zéro.

Le format du transfert de données est déterminé par les valeurs des propriétés WIA_IPA_FORMAT et WIA_IPA_TYMED de l’élément . L’application définit ces propriétés avec des appels à la méthode IWiaPropertyStorage::WriteMultiple .

Contrairement à la méthode IWiaDataTransfer::idtGetBandedData , IWiaDataTransfer::idtGetData transfère un fichier complet d’un appareil WIA vers une application plutôt qu’une seule bande de données. Le paramètre pMedium est un pointeur vers la structure STGMEDIUM qui contient des informations sur le support de stockage à utiliser pour le transfert de données. Les programmes utilisent le paramètre pIWiaDataCallback pour passer cette méthode un pointeur vers l’interface IWiaDataCallback . Régulièrement, cette méthode utilise le pointeur d’interface pour appeler la méthode BandedDataCallback et fournir à l’application status informations sur le transfert de données en cours.

Passez NULL comme valeur du membre lpszFileName de la structure pMedium pour permettre à WIA de déterminer le nom de fichier et l’emplacement du nouveau fichier. Au retour, le membre lpszFileName de la structure pMedium contient l’emplacement et le nom du nouveau fichier.

Si la valeur retournée par cette méthode est une valeur COM SUCCESS ou si le transfert est un transfert de fichiers multipage et que le code d’erreur retourné est WIA_ERROR_PAPER_JAM, WIA_ERROR_PAPER_EMPTY ou WIA_ERROR_PAPER_PROBLEM, WIA ne supprime pas le fichier.

Configuration requise