Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die IWiaSegmentationFilter::D etectRegions-Methode bestimmt die Unterbereiche eines Bilds, das auf der Flachbettplatte angeordnet ist, sodass jede Unterregion in einem separaten Bildelement erfasst werden kann.
Syntax
HRESULT DetectRegions(
[in] LONG lFlags,
[in, optional] IStream *pInputStream,
[in, optional] IWiaItem2 *pWiaItem2
);
Parameter
[in] lFlags
Derzeit nicht verwendet. Sollte auf Null festgelegt werden.
[in, optional] pInputStream
Gibt einen Zeiger auf das IStream-Vorschaubild an.
[in, optional] pWiaItem2
Gibt einen Zeiger auf das IWiaItem2-Element an, für das pInputStream abgerufen wurde. Der Segmentierungsfilter erstellt untergeordnete Elemente für dieses Element.
Rückgabewert
Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen COM-Standardfehlerwert zurück.
Hinweise
Diese Methode bestimmt die Teilbereiche des Bilds, das durch pInputStream dargestellt wird. Für jede erkannte Unterregion wird ein untergeordnetes Element für das Element IWiaItem2] erstellt, auf das der pWiaItem2-Parameter verweist. Für jedes untergeordnete Element muss der Segmentierungsfilter Werte für das umgebende Rechteck des zu scannenden Bereichs festlegen, wobei die folgenden EIGENSCHAFTEN des WIA-Scannerelements verwendet werden:
Für einen erweiterten Filter sind möglicherweise auch andere Scannerelementeigenschaften erforderlich, z. B. WIA_IPS_DESKEW_X und WIA_IPS_DESKEW_Y, wenn der Treiber das Entsperren unterstützt.
Wenn eine Anwendung IWiaSegmentationFilter::D etectRegions mehrmals aufruft , muss die Anwendung zuerst die untergeordneten Elemente löschen, die durch den letzten Aufruf der IWiaSegmentationFilter::D etectRegions-Methode erstellt wurden.
Wenn eine Anwendung Eigenschaften in pWiaItem2 ändert, müssen zwischen dem Abrufen des Bilds in pInputStream und dem Aufruf von IWiaSegmentationFilter::D etectRegions die ursprünglichen Eigenschafteneinstellungen (die Eigenschafteneinstellungen, die das Element beim Abrufen des Datenstroms hatte) wiederhergestellt werden. Dies kann mit IWiaPropertyStorage::GetPropertyStream und IWiaPropertyStorage::SetPropertyStream erfolgen.
Die Anwendung muss die IStream-Vorschau zurücksetzen, wenn ihr Aufruf denselben Stream mehrmals an den Segmentierungsfilter übergibt. Die Anwendung muss den Stream auch nach dem ersten Download und vor dem Aufruf von IWiaSegmentationFilter::D etectRegions zurücksetzen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | wia_lh.h (Wia_lh.h einschließen) |