IWiaImageFilter::InitializeFilter-Methode (wia_lh.h)

Artikel
03/01/2024

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

Syntax

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

Parameter

[in] pWiaItem2

Zeigt auf das IWiaItem2-Element , für das die Imageerfassung von der Anwendung initiiert wurde. Im Fall von IWiaTransfer::D ownload ist es das WIA-Element, von dem wir die IWiaTransfer-Schnittstelle abgerufen haben, und im Fall der Vorschaukomponente ist es das Element, das wir an die IWiaPreview::GetNewPreview-Methode übergeben.

[in] pWiaTransferCallback

Zeigt 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 COM-Standardfehlercode bei Einem Fehler zurück.

Hinweise

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

IWiaImageFilter::InitializeFilter muss nur die Verweise auf pWiaItem2 und pWiaTransferCallback speichern, die an ihn übergeben werden. Diese Schnittstellenzeiger sollten als Membervariablen in dieser Methode gespeichert werden, und AddRef sollte für jeden Schnittstellenzeiger aufgerufen werden. Diese beiden Schnittstellenzeiger werden in der Implementierung der Methoden IWiaTransferCallback::TransferCallback und IWiaTransferCallback::GetNextStream durch den Filter benötigt.

Diese Methode kann nicht direkt von der Anwendung aufgerufen werden.