IWiaSegmentationFilter::D etectRegions-Methode (wia_lh.h)
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) |