ImageScanner.ScanFilesToFolderAsync Metodo

Definizione

Spazio dei nomi:

Windows.Devices.Scanners

Avvia un processo di analisi con l'origine di analisi specificata e scrive una o più immagini in un unico file a più pagine, ad esempio TIFF, XPS e PDF; o uno o più file a pagina singola, ad esempio DIB, PNG, JPG e TIFF, nel percorso della cartella specificato. Restituisce lo stato di avanzamento dell'analisi.

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)

Parametri

scanSource

ImageScannerScanSource

Origine dell'analisi dell'immagine.

storageFolder

StorageFolder

Percorso della cartella di destinazione del file analizzato.

Restituisce

IAsyncOperationWithProgress<ImageScannerScanResult,UInt32>

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

IAsyncOperationWithProgress<ImageScannerScanResult,uint32_t>

L'elenco dei file di immagine analizzati da ImageScannerScanResult e lo stato di avanzamento del processo di analisi WIA da UInt32, che indica il numero di file trasferiti alla cartella di destinazione.

Attributi

RemoteAsyncAttribute

Commenti

I file vengono denominati usando nomi temporanei, con un'estensione di file standard che dipende dal tipo di formato di file.

Nota

Nell'app UWP, quando questo metodo viene richiamato, l'app deve essere visibile e in esecuzione in primo piano.

Quando l'app annulla la chiamata asincrona, avvia una richiesta di annullamento del processo di analisi corrente. Non esiste alcuna garanzia che se l'app annulla la chiamata asincrona che il processo di analisi verrà annullato. Se l'annullamento passa attraverso, lo scanner può arrestarsi per questi motivi:

• L'analisi dello scanner richiede alcuni secondi.
• Si ferma solo quando esaurisce la carta (per un'acquisizione di feeder).
• Completa l'esecuzione della scansione testa fino alla fine del letto e quindi restituisce completamente la testa di scansione alla sua posizione parcheggiata (per un'acquisizione flatbed).

Internamente, l'annullamento asincrono contrassegnerà il processo di analisi WIA 2.0 corrente come annullato dall'interno dell'app. Se il dispositivo WIA effettua il callback successivo al servizio WIA, l'annullamento del processo potrebbe o non essere stato comunicato correttamente al driver WIA. Tuttavia, anche se il driver WIA riceve la richiesta di annullamento da uno dei suoi callback non c'è garanzia che il driver possa arrestare correttamente l'analisi dello scanner, immediatamente o dopo qualsiasi periodo di tempo prevedibile.

Ecco l'elenco dei codici di errore HRESULT specifici di WIA, nonché i codici di errore HRESULT COM standard restituiti da questa funzione.

Nota

L'API chiamerà WinRTOriginateError e/o OriginateErrorWithResourceString (tutti gli errori WIA specifici avranno descrizioni degli errori localizzabili) per gli HRESULT specifici di WIA:

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

Esistono due casi speciali:

• Il valore HRESULT di WIA di S_FALSE verrà convertito in una chiamata asincrona annullata (AsyncStatus.Canceled).
• Il WIA_ERROR_PAPER_EMPTY di WIA verrà convertito da questa API in un risultato restituito (AsyncStatus.Completed) con un elenco vuoto di file (IVectorView.Size impostato su 0). Per evitare file orfani, questo metodo elimina tutti i file orfani rimanenti usati per trasferire le immagini in caso di errore, prima che si sia verificato l'errore. Il metodo salverà i file di trasferimento come file temporanei e li manterrà fino al completamento del processo di analisi. L'app deve indicare all'utente di ripetere l'analisi del documento.