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 |
|---|---|
|
Der Vorgang ist erfolgreich. |
|
Der Treiber unterstützt keine Segmentierung. |
|
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 |
|
| IDL |
|