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

[アーティクル]
08/08/2023

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 つのインターフェイスポインターが必要です。

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