IWiaImageFilter::FilterPreviewImage-Methode
Filtert das Vorschaubild.
Syntax
HRESULT FilterPreviewImage(
[in] LONG lFlags,
[in] IWiaItem2 *pWiaChildItem2,
[in] RECT InputImageExtents,
[in] IStream *pInputStream
);
Parameter
-
lFlags [ In]
-
Typ: LONG
Nicht verwendet. Auf 0 festlegen.
-
pWiaChildItem2 [ In]
-
Typ: IWiaItem2*
Das Element, das verarbeitet wird.
-
InputImageExtents [ In]
-
Typ: RECT
Die Koordinaten (im physischen Erfassungsbereich) des Images, das die Vorschaukomponente intern zwischenspeichert.
-
pInputStream [ In]
-
Typ: IStream*
Ein Zeiger auf die IStream-Schnittstelle für die zwischengespeicherten Bilddaten, die gefiltert werden.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S _ OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.
Hinweise
Rufen Sie diese Methode nicht direkt aus Ihrer Anwendung auf.
pWiaChildItem2 muss ein untergeordnetes Element des pWiaItem2 sein, das an IWiaImageFilter::InitializeFilterübergeben wurde.
InputImageExtents ist erforderlich, da der Bildverarbeitungsfilter für das Ausschneiden des Bildbereichs zuständig ist, der von pWiaChildItem2 aus den über pInputStream übergebenen Bilddaten dargestellt wird.
Eine Anwendung muss sicherstellen, dass pWiaChildItem2 über das gleiche Bildformat (WIA _ IPA _ FORMAT), auflösung (WIA _ IPS _ XRES und WIA _ IPS _ YRES) und Bittiefe (WIA _ IPA _ DEPTH) wie pWiaItem2 verfügt, als es an GetNewPreviewübergeben wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows [Nur Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2008-Desktop-Apps] |
| Header |
|
| IDL |
|