共用方式為

WIA 傳輸常數

  • 發行項

本主題包含用於 WIA IStream 型傳輸的常數清單。

這些常數分成三個子群組：

  • 項目類型

  • 回呼訊息

  • 傳輸旗標

項目類型

下表顯示哪些 WIA 項目類型位與數據流型數據傳輸有關。

名稱 描述
WiaItemTypeTransfer 此 WIA_IPA_ITEM_FLAGS 位應在能夠傳輸數據的所有項目上設定;也就是說，應用程式可以在已設定此位的專案上起始下載或上傳。

回呼訊息

下表顯示 IWiaTransferCallback：：TransferCallback 之 lFlags 參數的可能值。

名稱 描述
WIA_TRANSFER_MSG_STATUS 通知傳輸進度的應用程式。

pWiaTransferParams-lPercentComplete> 包含此專案的完成百分比和正在傳輸的頁面。
WIA_TRANSFER_MSG_END_OF_STREAM 通知應用程式不會再傳送任何數據至目前的數據流，而且可能會關閉數據流。

後續可能會在多專案或多頁傳輸中要求新的數據流。

驅動程式不會手動傳送此訊息。 當驅動程式要求下一個數據流時，WIA 服務會自動傳送此訊息。
WIA_TRANSFER_MSG_END_OF_TRANSFER 應用程式在傳輸結束時收到。

驅動程式不會傳送此訊息。 WIA 服務會在傳輸結束 (之後自動傳送此訊息，也就是 呼叫 IWiaMiniDrv：:d rvAcquireItemData 會傳回) 。
WIA_TRANSFER_MSG_ERROR Microsoft 保留供未來使用。
WIA_TRANSFER_MSG_DEVICE_STATUS 表示傳輸期間發生錯誤 (例如，紙夾) 。

pWiaTransferParams-hrErrorStatus> 包含錯誤狀態代碼。
WIA_TRANSFER_MSG_NEW_PAGE 表示在使用多頁 TIFF () 等多頁檔案中支援多個頁面的格式時，會在多頁傳輸期間傳輸新頁面。

傳輸旗標

下表顯示可能傳遞至 IWiaMiniDrv：:d rvAcquireItemData 的旗標。

名稱 描述
WIA_MINIDRV_TRANSFER_DOWNLOAD 表示傳輸是以數據流為基礎的下載作業 (，也就是從裝置傳輸到應用程式) 。

應用程式不會直接設定此位。 如果應用程式呼叫 IWiaTransfer：:D ownload，WIA 服務就會設定此位。
WIA_MINIDRV_TRANSFER_UPLOAD 表示傳輸是以數據流為基礎的上傳作業 (，也就是從應用程式傳送至裝置) 的數據。

應用程式不會直接設定此位。 如果應用程式呼叫 IWiaTransfer：：Upload，WIA 服務就會設定此位。
WIA_MINIDRV_TRANSFER_ACQUIRE_CHILDREN 表示驅動程式應該執行資料夾傳輸。 如果在資料夾專案上呼叫這個值，應用程式會要求傳送該資料夾的子系。

如果應用程式藉由將 IWiaTransfer：:D ownload的 lFlags 參數設定為 WIA_TRANSFER_ACQUIRE_CHILDREN，且驅動程式已指定它可以在一次掃描中傳輸多個子系，則會設定此值。 如果驅動程式無法執行這種類型的傳輸，WIA 服務將會對驅動程式進行多個呼叫，而且 不會 設定WIA_MINIDRV_TRANSFER_ACQUIRE_CHILDREN。