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 ，也可能是 WiaTransferParams 結構中的 lPercentComplete 值。 如果影像處理篩選器必須在呼叫其 Write 方法之間緩衝處理影像數據，再將數據寫入至應用程式提供的數據流，則必須修改 ulBytesWrittenToCurrentStream。 例如，如果正在執行桌面和/或旋轉，則需要這麼做。 如果不需要旋轉或輪替，則篩選最好在數據帶上運作。 lPercentComplete 不一定需要修改，因為此參數表示傳輸時間總計的百分比。 例如，此成員可由應用程式中的進度列使用。 請注意，影像處理篩選不應修改 結構的 lMessage 成員。 IWiaTransferCallback：：TransferCallback 也不應該「強制」它收到的任何訊息，即使它執行緩衝處理，而是應該修改 ulBytesWrittenToCurrentStream 成員。

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

規格需求