Méthode IWiaImageFilter ::InitializeFilter (wia_lh.h)

Article
02/27/2024

La méthode IWiaImageFilter ::InitializeFilter stocke les références aux paramètres pWiaItem2 et pWiaTransferCallback passés dans la méthode.

Syntaxe

HRESULT InitializeFilter(
  [in] IWiaItem2            *pWiaItem2,
  [in] IWiaTransferCallback *pWiaTransferCallback
);

Paramètres

[in] pWiaItem2

Pointe vers l’élément IWiaItem2 pour lequel l’acquisition d’image a été lancée par l’application. Dans le cas de IWiaTransfer ::D ownload, il s’agit de l’élément WIA à partir duquel nous avons obtenu l’interface IWiaTransfer , et dans le cas du composant Preview, c’est l’élément que nous transmettons à la méthode IWiaPreview ::GetNewPreview .

[in] pWiaTransferCallback

Pointe vers une interface IWiaTransferCallback . L’interface IWiaTransferCallback est l’interface de rappel de l’application, qui est passée à IWiaTransfer ::D ownload et IWiaPreview ::GetNewPreview.

Valeur retournée

Retourne S_OK en cas de réussite ou un code d’erreur COM standard en cas d’échec.

Remarques

Cette méthode est appelée par l’objet proxy COM avant que l’appel de téléchargement n’atteigne le service WIA. Cela se produit dans deux cas : lorsqu’une application appelle la méthode IWiaTransfer ::D ownload et lorsqu’une application appelle la méthode IWiaPreview ::GetNewPreview .

Tout ce qu’IWiaImageFilter ::InitializeFilter est nécessaire est de stocker les références à pWiaItem2 et pWiaTransferCallback qui y sont passées. Ces pointeurs d’interface doivent être stockés en tant que variables membres dans cette méthode et AddRef doit être appelé pour chaque pointeur d’interface. Ces deux pointeurs d’interface sont nécessaires dans l’implémentation du filtre des méthodes IWiaTransferCallback ::TransferCallback et IWiaTransferCallback ::GetNextStream .

Cette méthode ne peut pas être appelée directement par l’application.