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をする
IWiaTransferCallbackの