IWiaImageFilter::FilterPreviewImage-Methode

Artikel
06/13/2023

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 (auf dem physischen Erfassungsbereich) des Bilds, 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, gibt sie S_OK zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

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 verantwortlich ist, den pWiaChildItem2 aus den über pInputStream übergebenen Bilddaten darstellt.

Eine Anwendung muss sicherstellen, dass pWiaChildItem2 das gleiche Bildformat (WIA_IPA_FORMAT), auflösung (WIA_IPS_XRES und WIA_IPS_YRES) und Bittiefe (WIA_IPA_DEPTH) aufweist wie pWiaItem2 , als es an GetNewPreview übergeben wurde.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Header	Wia.h
IDL	Wia.idl

Freigeben über