IWiaItem::AnalyzeItem-Methode (wia_xp.h)

Die IWiaItem::AnalyzeItem-Methode bewirkt, dass das Windows Image Acquisition(WIA)-Hardwaregerät erfasst und versucht, zu erkennen, welche Datentypen vorhanden sind.

Syntax

HRESULT AnalyzeItem(
  [in] LONG lFlags
);

Parameter

[in] lFlags

Typ: LONG

Derzeit nicht verwendet. Sollte auf Null festgelegt werden.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode wird bei Scannern verwendet, um zu erkennen, welcher Datentyp auf einer Seite ist. Wenn eine Anwendung diese Methode aufruft, scannt und analysiert der WIA-Hardwaregerätetreiber die aktuelle Seite. Für jeden erkannten Datentyp wird ein IWiaItem-Objekt erstellt, um die Region auf der Seite darzustellen, die die Daten belegen.

Bildverarbeitungs- und OCR-Software kann diese Funktion verwenden, um Grafiken und Text auf einer Seite zu erkennen. Diese Methode fügt die von ihr erstellten Regionen der IWiaItem-Struktur des WIA-Geräts hinzu. Die Anwendung kann die einzelnen Regionen auswählen und die Standardmäßigen Datenübertragungsmethoden verwenden, um Daten von ihnen zu erfassen.

Bei Bedarf können Anwendungen die mit dieser Methode erstellten Regionen außer Kraft setzen.

Anforderungen