IWiaImageFilter::InitializeFilter-Methode (wia_lh.h)

Artikel
02/07/2025

Die IWiaImageFilter::InitializeFilter-Methode speichert die Verweise auf pWiaItem2 und pWiaTransferCallback Parameter, die an die Methode übergeben werden.

Syntax

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

Parameter

[in] pWiaItem2

Verweist auf das IWiaItem2 Element, für das die Bilderfassung von der Anwendung initiiert wurde. Bei IWiaTransfer::D ownloadist es das WIA-Element, aus dem wir die IWiaTransfer Schnittstelle abgerufen haben, und im Fall der Preview-Komponente ist es das Element, das wir an die IWiaPreview::GetNewPreview-Methode übergeben.

[in] pWiaTransferCallback

Verweist auf eine IWiaTransferCallback Schnittstelle. Die IWiaTransferCallback Schnittstelle ist die Rückrufschnittstelle der Anwendung, die an IWiaTransfer::D ownload und IWiaPreview::GetNewPreviewübergeben wird.

Rückgabewert

Gibt S_OK bei Erfolg oder einen standardmäßigen COM-Fehlercode für Fehler zurück.

Bemerkungen

Diese Methode wird vom COM-Proxyobjekt aufgerufen, bevor der Downloadaufruf den WIA-Dienst erreicht. Dies geschieht in zwei Fällen: wenn eine Anwendung IWiaTransfer::D ownload Methode aufruft und wenn eine Anwendung die IWiaPreview::GetNewPreview-Methode aufruft.

Alles, was IWiaImageFilter::InitializeFilter erforderlich ist, besteht darin, die Verweise auf pWiaItem2- und pWiaTransferCallback- zu speichern, die an sie übergeben werden. Diese Schnittstellenzeiger sollten in dieser Methode als Membervariablen gespeichert werden, und AddRef- für jeden Schnittstellenzeiger aufgerufen werden sollte. Diese beiden Schnittstellenzeiger werden in der Implementierung von IWiaTransferCallback::TransferCallback und IWiaTransferCallback::GetNextStream Methoden benötigt.

Diese Methode kann nicht direkt von der Anwendung aufgerufen werden.