Поделиться через

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 и ход выполнения задания проверки WIA из UInt32, который указывает, сколько файлов было передано в целевую папку.

Атрибуты
RemoteAsyncAttribute

Комментарии

Имена файлов используются с использованием временных имен со стандартным расширением файла, которое зависит от типа формата файла.

Примечание

В приложении UWP при вызове этого метода приложение должно быть видимым и выполняться на переднем плане.

Когда приложение отменяет асинхронный вызов, оно инициирует запрос на отмену текущего задания сканирования. Нет никакой гарантии, что если приложение отменит асинхронный вызов, задание сканирования будет отменено. Если отмена завершится, средство проверки может остановиться по следующим причинам:

  • Проверка прекращается через несколько секунд.
  • Он останавливается, только когда заканчивается бумага (для приобретения кормушки).
  • Он завершает запуск головки сканирования до конца кровати, а затем полностью возвращает головку сканирования в припаркованное место (для приобретения планшета).

Внутренне асинхронная отмена помечает текущее задание сканирования WIA 2.0 как отмененное в приложении. Если устройство WIA выполняет следующий обратный вызов к службе WIA, отмена задания может быть успешно передана драйверу WIA. Но даже если драйвер WIA получает запрос на отмену от одного из своих обратных вызовов, нет никакой гарантии, что драйвер сможет успешно остановить сканирование сканера сразу или через любой прогнозируемый период времени.

Ниже приведен список кодов ошибок HRESULT для WIA, а также стандартных кодов ошибок COM HRESULT, возвращаемых этой функцией.

Примечание

(API вызовет WinRTOriginateError и (или) OriginateErrorWithResourceString (все конкретные ошибки WIA будут иметь локализуемые описания ошибок) для HRESULT конкретного сбоя WIA):

WIA_ERROR_GENERAL_ERRORWIA_ERROR_PAPER_JAMWIA_ERROR_PAPER_EMPTY
WIA_ERROR_PAPER_PROBLEMWIA_ERROR_OFFLINEWIA_ERROR_BUSY
WIA_ERROR_WARMING_UPWIA_ERROR_USER_INTERVENTIONWIA_ERROR_ITEM_DELETED
WIA_ERROR_DEVICE_COMMUNICATIONWIA_ERROR_INVALID_COMMANDWIA_ERROR_INCORRECT_HARDWARE_SETTING
WIA_ERROR_DEVICE_LOCKEDWIA_ERROR_EXCEPTION_IN_DRIVERWIA_ERROR_INVALID_DRIVER_RESPONSE
WIA_ERROR_COVER_OPENWIA_ERROR_LAMP_OFFWIA_ERROR_MULTI_FEED

Существует два особых случая:

  • HRESULT WIA S_FALSE будет преобразован в отмененный асинхронный вызов (AsyncStatus.Canceled).
  • Этот API преобразует WIA_ERROR_PAPER_EMPTY WIA в успешное возвращение (AsyncStatus.Completed) с пустым списком файлов (IVectorView.Size, равным 0). Чтобы предотвратить потерянные файлы, этот метод удаляет все оставшиеся потерянные файлы, используемые для передачи изображений при сбое, до того, как произошел сбой. Метод сохраняет передаваемые файлы как временные файлы и сохраняет их до завершения задания сканирования. Приложение должно проинструктировать пользователя о повторном скане документа.

Применяется к