ImageScanner.ScanFilesToFolderAsync 方法

定義

命名空間:

Windows.Devices.Scanners

使用指定的掃描來源啟動掃描工作，並將一或多個影像寫入一個多頁檔案，例如 TIFF、XPS 和 PDF;或一或多個單頁檔案，例如 DIB、PNG、JPG 和 TIFF 到指定的資料夾位置。 傳回掃描的進度。

public:
 virtual IAsyncOperationWithProgress<ImageScannerScanResult ^, unsigned int> ^ ScanFilesToFolderAsync(ImageScannerScanSource scanSource, StorageFolder ^ storageFolder) = ScanFilesToFolderAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<ImageScannerScanResult, uint32_t> ScanFilesToFolderAsync(ImageScannerScanSource const& scanSource, StorageFolder const& storageFolder);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<ImageScannerScanResult,uint> ScanFilesToFolderAsync(ImageScannerScanSource scanSource, StorageFolder storageFolder);

function scanFilesToFolderAsync(scanSource, storageFolder)

Public Function ScanFilesToFolderAsync (scanSource As ImageScannerScanSource, storageFolder As StorageFolder) As IAsyncOperationWithProgress(Of ImageScannerScanResult, UInteger)

參數

scanSource

ImageScannerScanSource

影像掃描來源。

storageFolder

StorageFolder

掃描檔案的目的檔案夾位置。

傳回

IAsyncOperationWithProgress<ImageScannerScanResult,UInt32>

Windows.Foundation.IAsyncOperationWithProgress<Windows.Devices.Scanners.ImageScannerScanResult,unsigned int>

IAsyncOperationWithProgress<ImageScannerScanResult,uint32_t>

來自 ImageScannerScanResult 的掃描圖像檔案清單，以及 UInt32 中 WIA 掃描工作的進度，這表示有多少檔案已傳輸到目的檔案夾。

屬性

RemoteAsyncAttribute

備註

檔案是使用暫存名稱來命名，其副檔名取決於檔案格式類型。

注意

在 UWP 應用程式中，叫用此方法時，應用程式必須可見並在前景執行。

當應用程式取消非同步呼叫時，它會起始目前掃描工作的取消要求。 如果應用程式取消了掃描工作將會取消的非同步呼叫，則不保證。 如果取消通過，掃描器可能會因為下列原因而停止：

• 掃描器停止掃描前需要幾秒鐘的時間。
• 只有當送紙器取得) 用完紙張 (時，才會停止。
• 它會完成執行掃描頭到頂端，然後完全將掃描頭傳回其停駐位置 (，以取得平面取得) 。

非同步取消會在內部將目前的 WIA 2.0 掃描工作標示為從應用程式內取消。 如果 WIA 裝置對 WIA 服務進行下一次回呼，作業取消可能無法成功與 WIA 驅動程式通訊。 但是，即使 WIA 驅動程式從其中一個回呼收到取消要求，也不保證驅動程式可以成功阻止掃描器掃描，立即或在任何可預測的時間之後掃描。

以下是 WIA 特定 HRESULT 錯誤碼的清單，以及此函式傳回的標準 COM HRESULT 錯誤碼。

注意

(API 會呼叫 WinRTOriginateError 和/或 SourceErrorWithResourceString (所有特定 WIA 錯誤，將會有可當地語系化的錯誤描述，) WIA 特定失敗 HRESULTs) ：

WIA_ERROR_GENERAL_ERROR	WIA_ERROR_PAPER_JAM	WIA_ERROR_PAPER_EMPTY
WIA_ERROR_PAPER_PROBLEM	WIA_ERROR_OFFLINE	WIA_ERROR_BUSY
WIA_ERROR_WARMING_UP	WIA_ERROR_USER_INTERVENTION	WIA_ERROR_ITEM_DELETED
WIA_ERROR_DEVICE_COMMUNICATION	WIA_ERROR_INVALID_COMMAND	WIA_ERROR_INCORRECT_HARDWARE_SETTING
WIA_ERROR_DEVICE_LOCKED	WIA_ERROR_EXCEPTION_IN_DRIVER	WIA_ERROR_INVALID_DRIVER_RESPONSE
WIA_ERROR_COVER_OPEN	WIA_ERROR_LAMP_OFF	WIA_ERROR_MULTI_FEED

有兩種特殊案例：

• WIA 的 S_FALSE HRESULT 將會轉譯為已取消的非同步呼叫， (AsyncStatus.Canceled) 。
• WIA 的WIA_ERROR_PAPER_EMPTY會由此 API 轉譯為成功傳回 (AsyncStatus.Completed) ，並將 IVectorView.Size 設為 0) 的空白 (檔案清單。 若要防止孤立檔案，此方法會在失敗發生之前，刪除任何剩餘的孤立檔案，以在失敗時傳輸影像。 方法會將傳輸檔案儲存為暫存檔，並保留這些檔案，直到掃描工作完成為止。 應用程式必須指示使用者重新掃描檔。