IWiaImageFilter ::InitializeFilter, méthode (wia_lh.h)
La méthode IWiaImageFilter ::InitializeFilter stocke les références à pWiaItem2 et paramètres 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’images 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, il s’agit de l’élément que nous passons dans 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 de retour
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 atteigne le service WIA. Cela se produit dans deux cas : lorsqu’une application appelle méthode IWiaTransfer ::D ownload et lorsqu’une application appelle la méthode IWiaPreview ::GetNewPreview.
Tout ce que IWiaImageFilter ::InitializeFilter est nécessaire pour stocker les références à pWiaItem2 et pWiaTransferCallback qui 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 de méthodes IWiaTransferCallback ::TransferCallback et IWiaTransferCallback ::GetNextStream.
Cette méthode ne peut pas être appelée directement par l’application.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | wia_lh.h (inclure Wia_lh.h) |