次の方法で共有


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 項目です。プレビュー コンポーネントの場合は、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 呼び出す必要があります。 これらの 2 つのインターフェイス ポインターは、IWiaTransferCallback::TransferCallback IWiaTransferCallback::GetNextStream メソッドのフィルターの実装で必要です。

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

必要条件

要件 価値
ターゲット プラットフォーム デスクトップ
ヘッダー wia_lh.h (Wia_lh.h を含む)

関連項目

IWiaImageFilter

IWiaItem2する

IWiaPreview::GetNewPreview

IWiaTransferCallback

IWiaTransfer::D ownload