Méthode IWiaItem ::AnalyzeItem (wia_xp.h)

La méthode IWiaItem ::AnalyzeItem permet à l’appareil matériel WiA (Windows Image Acquisition) d’acquérir et d’essayer de détecter les types de données présents.

Syntaxe

HRESULT AnalyzeItem(
  [in] LONG lFlags
);

Paramètres

[in] lFlags

Type : LONG

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

Valeur retournée

Type : HRESULT

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

Remarques

Cette méthode est utilisée avec les scanneurs pour détecter le type de données d’une page. Lorsqu’une application appelle cette méthode, le pilote de périphérique matériel WIA analyse et analyse la page active. Pour chaque type de données détecté, il crée un objet IWiaItem pour représenter la région sur la page occupée par les données.

Le traitement d’images et le logiciel OCR peuvent utiliser cette fonctionnalité pour détecter des graphiques et du texte sur une page. Cette méthode ajoute les régions qu’elle crée dans l’arborescence IWiaItem de l’appareil WIA. L’application peut sélectionner les régions individuelles et utiliser les méthodes de transfert de données standard pour acquérir des données à partir de celles-ci.

Si nécessaire, les applications peuvent remplacer les régions créées par cette méthode.

Configuration requise