IWiaImageFilter::FilterPreviewImage, méthode

Article
06/13/2023

Filtre l’image d’aperçu.

Syntaxe

HRESULT FilterPreviewImage(
  [in] LONG      lFlags,
  [in] IWiaItem2 *pWiaChildItem2,
  [in] RECT      InputImageExtents,
  [in] IStream   *pInputStream
);

Paramètres

lFlags [in]

Type : LONG

Non utilisé. Définit la valeur 0.

pWiaChildItem2 [in]

Type : IWiaItem2*

Élément traité.

InputImageExtents [in]

Type : RECT

Coordonnées (sur la zone d’acquisition physique) de l’image que le composant d’aperçu met en cache en interne.

pInputStream [in]

Type : IStream*

Pointeur vers l’interface IStream pour les données d’image mises en cache filtrées.

Valeur retournée

Type : HRESULT

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

Notes

N’appelez pas cette méthode directement à partir de votre application.

pWiaChildItem2 doit être un élément enfant de pWiaItem2 qui a été passé à IWiaImageFilter::InitializeFilter.

InputImageExtents est nécessaire, car le filtre de traitement d’image est chargé de découper la zone d’image que pWiaChildItem2 représente à partir des données d’image transmises via pInputStream.

Une application doit s’assurer que pWiaChildItem2 a le même format d’image (WIA_IPA_FORMAT), résolution (WIA_IPS_XRES et WIA_IPS_YRES) et profondeur de bits (WIA_IPA_DEPTH) que pWiaItem2 lors du passage à GetNewPreview.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	Wia.h
IDL	Wia.idl

Partager via