Méthode IWiaTransferCallback::TransferCallback

Fournit des notifications de progression et d’autres lors d’un transfert.

Syntaxe

HRESULT TransferCallback(
  [in] LONG              lFlags,
  [in] WiaTransferParams *pWiaTransferParams
);

Paramètres

lFlags [in]

Type : LONG

Actuellement inutilisé. Doit être défini sur zéro (0).

pWiaTransferParams [in]

Type : WiaTransferParams*

Spécifie un pointeur vers une structure WiaTransferParams .

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, il retourne un code d’erreur HRESULT .

Notes

Lorsque cette méthode est implémentée par un filtre de traitement d’image, le minidriver Windows Image Acquisition (WIA) 2.0 l’appelle lors de l’acquisition d’image pour renvoyer des messages de progression à l’application.

Le IWiaTransferCallback::TransferCallback d’un filtre doit déléguer à la méthode IWiaTransferCallback::TransferCallback du rappel de l’application. En règle générale, le flux de filtre filtre les données qui lui sont transmises et écrit les données filtrées directement dans le flux fourni par l’application. Lorsque le filtre de traitement d’images stocke des données entre les appels à sa méthode IStream::Write , il doit également modifier les valeurs lPercentComplete et ulBytesWrittenToCurrentStream dans la structure WiaTransferParams .

Spécifications