IWiaTransferCallback::GetNextStream メソッド (wia_lh.h)

IWiaTransferCallback::GetNextStream メソッドは、画像処理フィルターによって実装されます。 これは、アプリケーションが IWiaTransfer::D ownload またはプレビュー コンポーネントの IWiaPreview::GetNewPreview](/windows/win32/wia/-wia-iwiapreview-getnewpreview) を呼び出した結果として WIA サービスによって呼び出されます。

構文

HRESULT GetNextStream(
  [in]  LONG    lFlags,
  [in]  BSTR    bstrItemName,
  [in]  BSTR    bstrFullItemName,
  [out] IStream **ppDestination
);

パラメーター

[in] lFlags

予約済み。0 に設定します。

[in] bstrItemName

項目の名前を含む文字列を指定します。

[in] bstrFullItemName

アイテムの完全な名前を含む文字列を指定します。

[out] ppDestination

出力ストリームへのポインターを指定します。

戻り値

成功した場合はS_OKを返し、それ以外の場合は標準の COM エラー値を返します。

備考

IWiaTransferCallback::GetNextStream と IWiaTransferCallback::TransferCallback のイメージ処理フィルターの実装は、WIA ミニ ドライバーがクライアントから宛先ストリームを要求したとき、およびミニ ドライバーが進行状況メッセージをアプリケーションに送信するときに、イメージの取得中に呼び出されます。

IWiaTransferCallback::GetNextStream の画像処理フィルターの実装は、アプリケーションの IWiaTransferCallback::GetNextStream メソッドに委任する必要があります。 次に、画像処理フィルターは、アプリケーション コールバックの IWiaTransferCallback::GetNextStream 実装によって返されるストリームを使用して、WIA サービスに返される独自のストリーム ("フィルター ストリーム") を作成します。

IWiaTransferCallback::GetNextStream 実装では、イメージ処理フィルターは、イメージが取得されるアイテムから、その画像処理に必要なプロパティを読み取る必要があります。 フィルターは、IWiaImageFilter::InitializeFilterに渡 pWiaItem2 からプロパティを直接読み取ってはいけません。実際の WIA アイテムを取得するには、この WIA アイテム IWiaItem2::FindItemByName](/windows/win32/wia/-wia-iwiaitem2-finditembyname) を呼び出す必要があります。 その理由は、フォルダー転送中に取得したイメージは、pWiaItem2 自体を するのではなく、pWiaItem2 の子項目に対応するためです。

このメソッドは、IWiaPreview::UpdatePreview中にプレビュー コンポーネントによって呼び出されません。

必要条件

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

関連項目

IWiaImageFilter::InitializeFilter

IWiaTransferCallbackの