IWiaMiniDrvCallBack：：MiniDrvCallback 方法 (wiamindr_lh.h)
MiniDrvCallback 方法提供回呼方法，供 WIA 迷你驅動程式在回呼數據傳輸期間使用。
語法
HRESULT MiniDrvCallback(
[in] LONG lReason,
[in] LONG lStatus,
[in] LONG lPercentComplete,
[in] LONG lOffset,
[in] LONG lLength,
[in] PMINIDRV_TRANSFER_CONTEXT pTranCtx,
[in] LONG lReserved
);
參數
[in] lReason
指定常數值，指定回呼狀態消息。 這個值是用來判斷回呼的用途，而且可以是下列其中一個值：
| 訊息 | 定義 |
|---|---|
| IT_MSG_DATA | 表示傳輸緩衝區包含數據區塊。 |
| IT_MSG_DATA_HEADER | 在數據傳輸之前接收。 表示傳送緩衝區指向定義數據傳輸專案的 WIA_DATA_CALLBACK_HEADER 結構。 |
| IT_MSG_DEVICE_STATUS | 回呼只包含裝置的狀態資訊。 |
| IT_MSG_FILE_PREVIEW_DATA | 表示預覽數據正在傳送至應用程式。 |
| IT_MSG_FILE_PREVIEW_DATA_HEADER | 表示在傳輸預覽數據之前，標頭正在傳送至應用程式。 |
| IT_MSG_NEW_PAGE | 指出頁面的數據傳輸已完成，而且正在傳送新的頁面。 |
| IT_MSG_STATUS | 回呼只包含有關傳輸的狀態資訊。 |
| IT_MSG_TERMINATION | 表示數據傳輸已完成。 |
[in] lStatus
指定傳輸的狀態。 此參數是下列值的位 OR：
| 狀態 | 定義 |
|---|---|
| IT_STATUS_TRANSFER_FROM_DEVICE | 從裝置傳輸數據。 |
| IT_STATUS_PROCESSING_DATA | 裝置和/或迷你驅動程式正在處理數據。 |
| IT_STATUS_TRANSFER_TO_CLIENT | 將數據從迷你驅動程式傳輸到 WIA 服務。 |
[in] lPercentComplete
指定目前傳輸的數據百分比。
[in] lOffset
指定從緩衝區開頭) 到傳輸緩衝區的目前位移 (。
[in] lLength
指定傳輸中包含的位元組數目。
[in] pTranCtx
指向包含數據傳輸值的 MINIDRV_TRANSFER_CONTEXT 結構。
[in] lReserved
保留的。 設定為零。
傳回值
如果方法成功，則會傳回 S_OK。 如果用戶端應用程式取消回呼，方法會傳回 S_FALSE。 如果方法失敗，它會傳回標準 COM 錯誤碼。
備註
完成百分比值會直接從驅動程式傳送。 WIA 服務不會調整值。
IT_MSG_FILE_PREVIEW_DATA_HEADER 適用於頻外數據。 這可讓應用程式執行檔案傳輸來顯示帶狀數據。 這適用於具有未知長度且沒有預覽掃描的捲動式掃描器。 此訊息中報告的信息應該與 IT_MSG_DATA_HEADER相同。 如果驅動程式支援此訊息，它可以在其檔案傳輸期間提供預覽數據。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | 桌面 |
| 標頭 | wiamindr_lh.h (包括 Wiamindr.h) |