IWiaImageFilter::InitializeFilter-Methode

Artikel
06/13/2023

Initialisiert den Filter. Wird von Windows Image Acquisition (WIA) 2.0 vor jedem Imagedownload aufgerufen.

Syntax

HRESULT InitializeFilter(
  [in] IWiaItem2            *pWiaItem2,
  [in] IWiaTransferCallback *pWiaTransferCallback
);

Parameter

pWiaItem2 [in]

Typ: IWiaItem2*

Gibt einen Zeiger auf das IWiaItem2-Element an, das das Vorschaubild darstellt.

pWiaTransferCallback [in]

Typ: IWiaTransferCallback*

Gibt einen Zeiger auf die IWiaTransferCallback-Schnittstelle der Anwendung an.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Diese Methode wird aufgerufen, wenn eine Anwendung Download aufruft und wenn eine Anwendung die Funktion der WIA 2.0 Preview-Komponente GetNewPreview aufruft. IWiaImageFilter::InitializeFilter speichert die Verweise auf pWiaItem2 und pWiaTransferCallback , um an diese Funktionen zu übergeben. Diese beiden Schnittstellenzeiger sollten als Membervariablen gespeichert werden, und IUnknown::AddRef sollte jeweils aufgerufen werden. Die Schnittstellenzeiger werden auch in der Implementierung von TransferCallback und GetNextStream während der Bilderfassung durch den Filter benötigt.

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