IWiaImageFilter::InitializeFilter メソッド (wia_lh.h)

IWiaImageFilter::InitializeFilter メソッドは、メソッドに渡される pWiaItem2 および pWiaTransferCallback パラメーターへの参照を格納します。

構文

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

パラメーター

[in] pWiaItem2

イメージの取得がアプリケーションによって開始された IWiaItem2 項目を指します。 IWiaTransfer::D ownload の場合は、IWiaTransfer インターフェイスを取得した WIA アイテムです。Preview コンポーネントの場合は、IWiaPreview::GetNewPreview メソッドに渡す項目です。

[in] pWiaTransferCallback

IWiaTransferCallback インターフェイスを指します。 IWiaTransferCallback インターフェイスは、アプリケーションのコールバック インターフェイスであり、IWiaTransfer::D ownload および IWiaPreview::GetNewPreview に渡されます。

戻り値

成功した場合はS_OK、失敗した場合は標準の COM エラー コードを返します。

注釈

このメソッドは、ダウンロード呼び出しが WIA サービスに到達する前に、COM プロキシ オブジェクトによって呼び出されます。 これは、アプリケーションが IWiaTransfer::D ownload メソッドを呼び出すときと、アプリケーションが IWiaPreview::GetNewPreview メソッドを呼び出すときの 2 つのケースで発生します。

IWiaImageFilter::InitializeFilter に必要なのは、pWiaItem2 への参照と、それに渡される pWiaTransferCallback への参照を格納することです。 これらのインターフェイス ポインターは、このメソッドのメンバー変数として格納し、各インターフェイス ポインターに対して AddRef を呼び出す必要があります。 フィルターの IWiaTransferCallback::TransferCallback メソッドと IWiaTransferCallback::GetNextStream メソッドの実装では、これら 2 つのインターフェイス ポインターが必要です。

このメソッドは、アプリケーションから直接呼び出すことはできません。

要件

要件
対象プラットフォーム デスクトップ
Header wia_lh.h (Wia_lh.h を含む)

こちらもご覧ください

IWiaImageFilter

IWiaItem2

IWiaPreview::GetNewPreview

IWiaTransferCallback

IWiaTransfer::D ownload