共用方式為


IWiaTransferCallback::GetNextStream 方法 (wia_lh.h)

IWiaTransferCallback::GetNextStream 方法是由影像處理篩選器實作。 WIA 服務會呼叫 WIA 服務,因為呼叫 IWiaTransfer::D ownload 或預覽元件的 IWiaPreview::GetNewPreview] (/windows/win32/wia/-wia-iwiapreview-getnewpreview) 。

語法

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

參數

[in] lFlags

保留,設定為零。

[in] bstrItemName

指定包含項目名稱的字串。

[in] bstrFullItemName

指定包含專案完整名稱的字串。

[out] ppDestination

指定輸出數據流的指標。

傳回值

如果成功,則傳回S_OK,否則傳回標準 COM 錯誤值。

備註

影像處理篩選器實作 IWiaTransferCallback::GetNextStreamIWiaTransferCallback::TransferCallback 會在映像擷取期間呼叫、WIA 迷你驅動程式向用戶端要求目的地數據流,以及迷你驅動程式將進度訊息傳回應用程式時。

影像處理篩選器的 IWiaTransferCallback::GetNextStream 實作必須委派給應用程式的 IWiaTransferCallback::GetNextStream 方法。 接著,影像處理篩選器會使用應用程式回呼 IWiaTransferCallback::GetNextStream 實作所傳回的數據流, (傳回 WIA 服務的「篩選數據流」) 建立自己的數據流。

在其 IWiaTransferCallback::GetNextStream 實作中,影像處理篩選器應該從要取得影像的專案讀取其影像處理所需的屬性。 篩選不得直接從傳入 IWiaImageFilter::InitializeFilterpWiaItem2 讀取屬性;而是必須在此 WIA 專案上呼叫 IWiaItem2::FindItemByName] (/windows/win32/wia/-wia-iwiaitem2-finditembyname) ,以取得實際的 WIA 專案。 原因是在資料夾傳輸時,取得的影像會對應至 pWiaItem2 的子專案,而不是 pWiaItem2 本身。

在 IWiaPreview::UpdatePreview 期間,預覽元件不會呼叫這個方法。

規格需求

需求
目標平台 桌面
標頭 wia_lh.h (包含 Wia_lh.h)

另請參閱

IWiaImageFilter::InitializeFilter

IWiaTransferCallback