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
Wia.h
IDL
Wia.idl