ImageScanner.ScanFilesToFolderAsync Méthode

Définition

Espace de noms:

Windows.Devices.Scanners

Démarre un travail d’analyse avec la source d’analyse spécifiée et écrit une ou plusieurs images dans un fichier multipage comme TIFF, XPS et PDF ; ou un ou plusieurs fichiers monopage comme DIB, PNG, JPG et TIFF à l’emplacement de dossier spécifié. Retourne la progression de l’analyse.

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)

Paramètres

scanSource

ImageScannerScanSource

Source d’analyse d’image.

storageFolder

StorageFolder

Emplacement du dossier cible du fichier analysé.

Retours

IAsyncOperationWithProgress<ImageScannerScanResult,UInt32>

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

IAsyncOperationWithProgress<ImageScannerScanResult,uint32_t>

Liste des fichiers image analysés à partir d’ImageScannerScanResult et la progression du travail d’analyse WIA à partir de UInt32, qui indique le nombre de fichiers transférés vers le dossier cible.

Attributs

RemoteAsyncAttribute

Remarques

Les fichiers sont nommés à l’aide de noms temporaires, avec une extension de fichier standard qui dépend du type de format de fichier.

Notes

Dans l’application UWP, lorsque cette méthode est appelée, l’application doit être visible et s’exécuter au premier plan.

Lorsque l’application annule l’appel asynchrone, elle lance une demande d’annulation du travail d’analyse en cours. Rien ne garantit que si l’application annule l’appel asynchrone, le travail d’analyse sera annulé. Si l’annulation est effectuée, l’analyseur peut s’arrêter pour les raisons suivantes :

• Il faut quelques secondes avant que le scanneur arrête l’analyse.
• Il ne s’arrête que lorsqu’il manque de papier (pour une acquisition de chargeur).
• Il termine l’exécution de la tête de balayage jusqu’au bout du lit, puis retourne entièrement la tête de balayage à son emplacement garé (pour une acquisition à plat).

En interne, l’annulation asynchrone signale le travail d’analyse WIA 2.0 actuel comme annulé à partir de l’application. Si l’appareil WIA effectue le prochain rappel au service WIA, l’annulation du travail peut ou ne pas être correctement communiquée au pilote WIA. Toutefois, même si le pilote WIA reçoit la demande d’annulation de l’un de ses rappels, il n’y a aucune garantie que le pilote puisse empêcher le scanneur de l’analyse, immédiatement ou après une période prévisible.

Voici la liste des codes d’erreur HRESULT spécifiques à WIA, ainsi que des codes d’erreur COM HRESULT standard retournés par cette fonction.

Notes

(l’API appelle WinRTOriginateError et/ou OriginateErrorWithResourceString (toutes les erreurs WIA spécifiques auront des descriptions d’erreurs localisables) pour les HRESULT d’échec spécifiques à 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

Il existe deux cas particuliers :

• Le HRESULT du WIA de S_FALSE sera traduit en appel asynchrone annulé (AsyncStatus.Canceled).
• Les WIA_ERROR_PAPER_EMPTY du WIA seront traduits par cette API en un retour réussi (AsyncStatus.Completed) avec une liste vide de fichiers (IVectorView.Size défini sur 0). Pour empêcher les fichiers orphelins, cette méthode supprime tous les fichiers orphelins restants utilisés pour transférer des images en cas d’échec, avant que l’échec ne se produise. La méthode enregistre les fichiers de transfert en tant que fichiers temporaires et les conserve jusqu’à la fin du travail d’analyse. L’application doit indiquer à l’utilisateur de réanalyser le document.