IWiaErrorHandler::ReportStatus, méthode
Gère les messages status et d’erreur lors des transferts de données d’image et les affiche à l’utilisateur.
Syntaxe
HRESULT ReportStatus(
[in] HWND hwndParent,
[in] IUnknown *punkItem,
[in] HRESULT hrStatus,
[in] LONG cbResLength,
[in] BYTE *pbData
);
Paramètres
-
hwndParent [in]
-
Type : HWND
HWND qui est la fenêtre parente de la fenêtre de message.
-
punkItem [in]
-
Type : IUnknown*
Pointeur vers l’interface IUnknown de l’élément en cours de transfert. Cet objet implémente au minimum IWiaItem2 et IWiaDataTransfer.
-
hrStatus [in]
-
Type : HRESULT
HRESULT qui est le code status reçu par BandedDataCallback.
-
cbResLength [in]
-
Type : LONG
LONG qui correspond à la taille des données référencées par pbData.
-
pbData [in]
-
Type : BYTE*
Pointeur vers la mémoire tampon de données reçue par BandedDataCallback.
Valeur retournée
Type : HRESULT
Retourne hrStatus si l’erreur ne peut pas être récupérée. Sinon, elle retourne l’une des valeurs suivantes.
Code de retour | Description |
---|---|
|
L’action appropriée a été prise pour corriger l’erreur et le transfert peut continuer. |
|
Aucune action n’a été prise pour gérer l’erreur ou le rapport status à l’utilisateur. |
|
L’utilisateur a choisi d’abandonner le transfert en réponse à la boîte de dialogue affichée. |
Notes
Windows Image Acquisition (WIA) 2.0 appelle IWiaErrorHandler::ReportStatus lorsque le pilote envoie un message IT_MSG_DEVICE_STATUS à BandedDataCallback. Cette méthode gère le message et affiche à l’utilisateur des informations sur le status ou l’erreur. Si le message concerne une erreur, la méthode permet à l’utilisateur de choisir, si possible, d’essayer de récupérer après l’erreur et de poursuivre le transfert ou d’abandonner.
hrStatus est défini sur WIA_STATUS_TRANSFER_BEGIN pour informer le gestionnaire qu’un transfert a démarré. Il est défini sur WIA_STATUS_TRANSFER_END lorsque le transfert est terminé.
Si hrStatus est SEVERITY_SUCCESS, l’utilisateur doit être autorisé à annuler le transfert.
Spécifications
Condition requise | Valeur |
---|---|
Client minimal pris en charge |
Windows Vista [applications de bureau uniquement] |
Serveur minimal pris en charge |
Windows Server 2008 [applications de bureau uniquement] |
En-tête |
|
IDL |
|
Bibliothèque |
|
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour