IWiaPreview::D etectRegions-Methode

Ruft den Treibersegmentierungsfilter auf und übergibt das ungefilterte Bild, das von der IWiaPreview::GetNewPreview-Methode zwischengespeichert wird, an den Filter.

Syntax

HRESULT DetectRegions(
  [in] LONG lFlags
);

Parameter

lFlags [ In]

Typ: LONG

Wird nicht verwendet. Wird auf 0 (null) festgelegt.

Rückgabewert

Typ: HRESULT

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
S _ OK
Der Vorgang ist erfolgreich.
E _ NOTIMPL
Der Treiber unterstützt keine Segmentierung.
otherwise
Ein COM-Standardfehlercode.

Hinweise

Eine Anwendung muss IWiaPreview::GetNewPreview aufrufen, bevor sie diese Funktion aufruft.

Wenn die Windows Image Acquisition (WIA) 2.0 Preview Component IWiaPreview::D etectRegions aufruft, ruft sie den Treibersegmentierungsfilter auf und übergibt die IWiaItem2-Schnittstelle, die zuvor an IWiaPreview::GetNewPreviewübergeben wurde. Außerdem wird das intern zwischengespeicherte Image an den Filter übergeben. Der Segmentierungsfilter verwendet das zwischengespeicherte Image, um die untergeordneten Erweiterungen zu erstellen.

Wenn eine Anwendung Eigenschaften der IWiaItem2-Schnittstelle ändert, nachdem sie IWiaPreview::GetNewPreviewaufruft, müssen die ursprünglichen Eigenschaften wiederhergestellt werden, bevor die Anwendung IWiaPreview::D etectRegions aufruft. Verwenden Sie GetPropertyStream und SetPropertyStream, um die ursprünglichen Eigenschaften wiederherzustellen.

IWiaPreview::D etectRegions wird verwendet, um die "Unterbereiche" des zwischengespeicherten Images zu bestimmen. Für jede erkannte Unterregion wird unter der IWiaItem2-Schnittstelle ein neues untergeordnetes WIA 2.0-Element erstellt. Für jedes untergeordnete Element muss der Segmentierungsfilter die Werte für die folgenden WIA 2.0-Eigenschaften festlegen: WIA _ IPS _ XPOS, WIA _ IPS _ YPOS, WIA _ IPS _ XEXTENT und WIA _ IPS _ YEXTENT. Ein erweiterter Filter legt andere WIA 2.0-Eigenschaften fest, z. B. WIA _ IPS _ DESKEW _ X und WIA _ IPS _ DESKEW _ Y, wenn der Treiber das Deaktivieren unterstützt. Die Eigenschaften WIA _ IPS _ XPOS, WIA _ IPS _ YPOS, WIA _ IPS _ XEXTENT und WIA _ IPS _ YEXTENT stellen das umschließende Rechteck des zu überprüfenden Bereichs dar.

Der Treiber unterstützt möglicherweise keine Segmentierung. Vor dem Aufrufen von IWiaPreview::D etectRegions überprüft eine Anwendung in der Regel, ob der Treiber die WIA _ IPS _ SEGMENTATION-Eigenschaft unterstützt. Wenn die Eigenschaft nicht implementiert ist, wird die Segmentierung nicht unterstützt, und IWiaPreview::D etectRegions schlägt fehl und gibt E _ NOTIMPL zurück.

Die Anwendung muss die untergeordneten Elemente bereinigen, die durch Aufrufen von IWiaPreview::D etectRegions erstellt werden. Wenn eine Anwendung beispielsweise einen zusätzlichen Aufruf von IWiaPreview::D etectRegions für dasselbe Element vornimmt, muss sie die vorherigen untergeordneten Elemente bereinigen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows [Nur Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2008-Desktop-Apps]
Header
Wia.h
IDL
Wia.idl