Méthode IWiaTransferCallback ::GetNextStream (wia_lh.h)

Article
02/29/2024

La méthode IWiaTransferCallback ::GetNextStream est implémentée par un filtre de traitement d’image. Il est appelé par le service WIA à la suite d’une application appelant IWiaTransfer ::D ownload ou IWiaPreview ::GetNewPreview](/windows/win32/wia/-wia-iwiapreview-getnewpreview).

Syntaxe

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

Paramètres

[in] lFlags

Réservé, défini sur zéro.

[in] bstrItemName

Spécifie une chaîne contenant le nom de l’élément.

[in] bstrFullItemName

Spécifie une chaîne contenant le nom complet de l’élément.

[out] ppDestination

Spécifie un pointeur vers le flux de sortie.

Valeur retournée

Retourne S_OK en cas de réussite, ou une valeur d’erreur COM standard dans le cas contraire.

Remarques

L’implémentation par un filtre de traitement d’images de IWiaTransferCallback ::GetNextStream et IWiaTransferCallback ::TransferCallback est appelée lors de l’acquisition d’images, lorsque le mini-pilote WIA demande le flux de destination à partir du client et lorsque le mini-pilote envoie des messages de progression à l’application.

L’implémentation d’IWiaTransferCallback ::GetNextStream par un filtre de traitement d’images doit être déléguée à la méthode IWiaTransferCallback ::GetNextStream de l’application. Le filtre de traitement des images utilise ensuite le flux retourné par l’implémentation IWiaTransferCallback ::GetNextStream du rappel de l’application pour créer son propre flux (le « flux de filtrage ») qu’il transmet au service WIA.

Dans son implémentation IWiaTransferCallback ::GetNextStream , le filtre de traitement d’image doit lire les propriétés nécessaires pour son traitement d’image à partir de l’élément pour lequel l’image est acquise. Le filtre ne doit pas lire les propriétés directement à partir du pWiaItem2 passé dans IWiaImageFilter ::InitializeFilter ; il doit plutôt appeler IWiaItem2 ::FindItemByName](/windows/win32/wia/-wia-iwiaitem2-finditembyname) sur cet élément WIA pour obtenir l’élément WIA réel. La raison en est que pendant le transfert d’un dossier, les images acquises correspondent aux éléments enfants de pWiaItem2 plutôt qu’à pWiaItem2 lui-même.

Cette méthode n’est pas appelée par le composant en préversion pendant IWiaPreview ::UpdatePreview.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	wia_lh.h (include Wia_lh.h)

Voir aussi

IWiaImageFilter ::InitializeFilter

IWiaTransferCallback

Partager via