Méthode IWiaSegmentationFilter ::D etectRegions (wia_lh.h)
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) |