共用方式為

IWiaTransferCallback：：TransferCallback 方法 （wia_lh.h）

  • 發行項

IWiaTransferCallback：：TransferCallback 方法是由影像處理篩選器實作。 WIA 服務會呼叫它，因為應用程式呼叫 IWiaTransfer：:D ownload 或預覽元件的 IWiaPreview：：GetNewPreview。

語法

HRESULT TransferCallback(
  [in] LONG              lFlags,
  [in] WiaTransferParams *pWiaTransferParams
);

參數

[in] lFlags

目前未使用。 應該設定為零。

[in] pWiaTransferParams

指定 WiaTransferParams 結構的指標。

傳回值

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

言論

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

影像處理篩選器 IWiaTransferCallback：：TransferCallback 方法必須委派給應用程式回呼的 IWiaTransferCallback：：TransferCallback 方法。 在許多情況下，影像處理篩選條件的 IWiaTransferCallback：：TransferCallback 實作也必須修改 ulBytesWrittenToCurrentStream，而且也可能 lPercentComplete WiaTransferParams 結構中的值。 ulBytesWrittenToCurrentStream，如果影像處理篩選器必須在呼叫其 Write 方法之前緩衝處理影像數據，然後再將數據寫入應用程式提供的數據流。 例如，如果執行桌面和/或輪替，則需要這樣做。 如果不需要旋轉或輪替，篩選應該最好在數據帶上運作。 lPercentComplete 不一定需要修改，因為此參數表示總傳輸時間的百分比。 例如，此成員可以供應用程式中的進度列使用。 請注意，影像處理篩選不應該修改 結構的 lMessage 成員。 IWiaTransferCallback：：TransferCallback 也不應該「吞咽」它接收的任何訊息，即使它執行緩衝處理，也應該修改 ulBytesWrittenToCurrentStream 成員。

在 IWiaPreview：：UpdatePreview期間，預覽元件不會呼叫此方法。

要求

要求 價值
目標平臺 桌面
標頭 wia_lh.h （包括 Wia_lh.h）