Méthode IWiaMiniDrvTransferCallback ::GetNextStream (wiamindr_lh.h)

Appelé par le mini-pilote WIA pour obtenir un flux pour le transfert de données actuel (téléchargement ou chargement).

Syntaxe

HRESULT GetNextStream(
  [in]  LONG    lFlags,
  [in]  BSTR    bstrItemName,
  [in]  BSTR    bstrFullItemName,
  [out] IStream **ppIStream
);

Paramètres

[in] lFlags

Représente les bits d’indicateur. Ce paramètre n’est pas utilisé et doit toujours être défini sur zéro (0) par l’appelant.

[in] bstrItemName

Nom de l’élément qui effectuera le transfert de données.

Pour plus d’informations, consultez WIA_IPA_ITEM_NAME.

[in] bstrFullItemName

Nom complet de l’élément qui effectuera le transfert de données.

Pour plus d’informations, consultez WIA_IPA_FULL_ITEM_NAME.

[out] ppIStream

Pointeur vers un objet IStream .

Valeur retournée

Cette méthode retourne S_OK lorsque l’appel réussit. Sinon, il retourne un code d’erreur HRESULT approprié.

Remarques

Lorsque le client demande à ignorer le transfert de données, la méthode GetNextStream retourne WIA_STATUS_SKIP_ITEM. Le mini-pilote WIA doit ignorer le transfert d’image actuel et poursuivre le transfert d’image suivant, le cas échéant. Par exemple, pour un transfert de téléchargement, terminez l’analyse de l’image actuelle, puis ignorez les données de l’image.

Lorsque la séquence de transfert actuelle est annulée, la méthode GetNextStream retourne S_FALSE.

Configuration requise

Voir aussi

Annulation des transferts de données

Transfert de données entre l’application héritée et le pilote Windows

IWiaMiniDrvTransferCallback

WIA_IPA_FULL_ITEM_NAME

WIA_IPA_ITEM_NAME