Méthode IWiaSegmentationFilter ::D etectRegions (wia_lh.h)

Article
02/27/2024

La méthode IWiaSegmentationFilter ::D etectRegions détermine les sous-régions d’une image disposée sur la plaque à plat afin que chaque sous-région puisse être acquise dans un élément d’image distinct.

Syntaxe

HRESULT DetectRegions(
  [in]           LONG      lFlags,
  [in, optional] IStream   *pInputStream,
  [in, optional] IWiaItem2 *pWiaItem2
);

Paramètres

[in] lFlags

Actuellement inutilisé. Doit être défini sur zéro (0).

[in, optional] pInputStream

Spécifie un pointeur vers l’image d’aperçu IStream .

[in, optional] pWiaItem2

Spécifie un pointeur vers l’élément IWiaItem2 pour lequel pInputStream a été acquis. Le filtre de segmentation crée des éléments enfants pour cet élément.

Valeur retournée

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

Remarques

Cette méthode détermine les sous-régions de l’image représentée par pInputStream. Pour chaque sous-région détectée, il crée un élément enfant pour l’élément IWiaItem2] pointé par le paramètre pWiaItem2 . Pour chaque élément enfant, le filtre de segmentation doit définir des valeurs pour le rectangle englobant de la zone à analyser, à l’aide des propriétés d’élément du scanneur WIA suivantes :

Un filtre plus avancé peut également nécessiter d’autres propriétés d’élément du scanneur, telles que WIA_IPS_DESKEW_X et WIA_IPS_DESKEW_Y, si le pilote prend en charge la suppression.

Si une application appelle IWiaSegmentationFilter ::D etectRegions plusieurs fois, l’application doit d’abord supprimer les éléments enfants créés par le dernier appel à la méthode IWiaSegmentationFilter ::D etectRegions .

Si une application modifie des propriétés en pWiaItem2, entre l’acquisition de l’image dans pInputStream et son appel à IWiaSegmentationFilter ::D etectRegions, les paramètres de propriété d’origine (les paramètres de propriété que l’élément avait lors de l’acquisition du flux) doivent être restaurés. Pour ce faire, utilisez IWiaPropertyStorage ::GetPropertyStream et IWiaPropertyStorage ::SetPropertyStream.

L’application doit réinitialiser la préversion IStream si son appel passe plusieurs fois le même flux dans le filtre de segmentation. L’application doit également réinitialiser le flux après le téléchargement initial et avant d’appeler IWiaSegmentationFilter ::D etectRegions.

Configuration requise

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

Voir aussi

IStream

IWiaItem2

IWiaPropertyStorage

Partager via