COMMENT FAIRE: activer l'enregistrement dans Wiadebug.log

Traductions disponibles Traductions disponibles
Numéro d'article: 307001 - Voir les produits auxquels s'applique cet article
Ancien nº de publication de cet article : F307001
Agrandir tout | Réduire tout

Sommaire

Résumé

Par défaut, le service Acquisition d'image Windows (WIA) enregistre les erreurs dans un fichier appelé Wiadebug.log, dans le dossier Windows_folder. Cet article décrit la procédure à suivre pour effectuer des enregistrements dans le fichier Wiadebug.log.


Activer l'enregistrement dans le fichier Wiadebug.log

Les informations que le service WIA enregistre dans ce fichier peuvent être très utiles au cours du développement de pilotes. Le niveau d'enregistrement est contrôlé par une entrée du Registre. En ce qui concerne l'acquisition d'image Windows (WIA), cette clé réside dans la clé de registre suivante, où Module_name est le nom du module binaire approprié :
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\StillImage\Debug\ Module_name\DebugFlags
En ce qui concerne le service WIA, le module binaire approprié est Wiaservc.dll.

La valeur dans DebugFlags contrôle le niveau d'enregistrement. La liste suivante décrit trois des paramètres :
  • 0x00000001 : Afficher les messages d'erreur.
  • 0x00000002 : Afficher les messages d'avertissement.
  • 0x00000004 : Afficher les messages de trace.
La valeur pour DebugFlags est une valeur d'indicateur ; ceci signifie que des paramètres différents peuvent être lus simultanément. Pour exécuter simultanément l'enregistrement des erreurs, des avertissements et des traces, fixez DebugFlags à 0x0000007.

Si vous modifiez la valeur de DebugFlags, interrompez le service WIA (stisvc), puis redémarrez-le pour appliquer les modifications.

Pour interrompre le service d'images fixes, ouvrez une invite de commande, puis exécutez la commande suivante :
net stop stisvc
Pour démarrer le service d'images fixes, ouvrez une invite de commande, puis exécutez la commande suivante :
net start stisvc
REMARQUE : Un enregistrement excessif peut entraîner une baisse des performances. Augmentez uniquement le niveau d'enregistrement lorsque vous essayez de résoudre un problème spécifique. Après avoir résolu le problème, définissez le niveau d'enregistrement à son niveau initial.


Dépannage

Le scénario suivant décrit un problème typique et le mode d'utilisation des informations du fichier Wiadebug.log pour résoudre le problème en question.

Scénario Vous avez écrit un programme pour tester le pilote de scanneur en cours de développement. Pour l'un des tests, vous essayez de fixer le paramètre Points par pouce (dpi) du scanneur à 1200 mais vous remarquez que cette action entraîne une erreur.

Les données suivantes sont enregistrées dans Wiadebug.log :
wiasGetChangedValueLong, validate prop 6147 failed hr: 0x80070057
wiasUpdateScanRect, CheckXResAndUpdate failed (0x80070057)
CDrvWrap::WIA_drvValidateItemProperties, Erreur de dénomination du pilote :
drvValidateItemProperties with hr = 0x80070057
REMARQUE : Ce comportement est typique si un programme écrit une valeur non valide.

Ces entrées du journal indiquent que le pilote rapporte une valeur non valide écrite par le programme. Ces informations n'indiquent pas précisément la nature du problème. Si vous augmentez le niveau d'enregistrement WIA pour mentionner les avertissements ainsi que les erreurs, les informations suivantes sont enregistrées dans Wiadebug.log :
  • 75
  • 100
  • 150
  • 200
  • 300
  • 600
wiasValidateItemProperties, valeur LISTE non valide pour :
propID) Résolution horizontale, valeur = 1200
Les valeurs valides sont : wiasGetChangedValueLong, validate prop 6147 failed hr: 0x80070057
wiasUpdateScanRect, CheckXResAndUpdate failed (0x80070057)
CDrvWrap::WIA_drvValidateItemProperties, Erreur de dénomination du pilote :
drvValidateItemProperties with hr = 0x80070057
REMARQUE : Ce comportement est typique si le programme écrit une valeur non valide.

L'édition montre que la propriété Résolution horizontale est à l'origine de l'échec. Le programme essaie de fixer la résolution à 1200 mais la liste des résolutions prises en charge n'inclut pas 1200 ; par conséquent, l'assistance de la validation du service WIA (wiasValidateItemProperties) rejette la demande d'activation de cette valeur.

Lorsque vous avez identifié le problème, vous pouvez déterminer si vous souhaitez modifier le pilote ou le programme. Si les spécifications du scanneur l'autorisent à prendre en charge toutes les résolutions entre 100 et 1400 points par pouce, le pilote doit être en mesure de traiter une demande pour 1200 points par pouce. Si le scanneur ne prend pas en charge ce paramètre, modifiez le programme afin qu'il n'essaie pas de définir la résolution horizontale sur une valeur non valide pour cette propriété. Dans ce cas, le programme doit contrôler la validité de la valeur avant d'essayer de définir une propriété pour cette valeur.




Propriétés

Numéro d'article: 307001 - Dernière mise à jour: mercredi 30 avril 2003 - Version: 1.0
Les informations contenues dans cet article s'appliquent au(x) produit(s) suivant(s):
  • Microsoft Windows XP Professionnel
Mots-clés : 
kbhowto kbhowtomaster kbtool KB307001
L'INFORMATION CONTENUE DANS CE DOCUMENT EST FOURNIE PAR MICROSOFT SANS GARANTIE D'AUCUNE SORTE, EXPLICITE OU IMPLICITE. L'UTILISATEUR ASSUME LE RISQUE DE L'UTILISATION DU CONTENU DE CE DOCUMENT. CE DOCUMENT NE PEUT ETRE REVENDU OU CEDE EN ECHANGE D'UN QUELCONQUE PROFIT.

Envoyer des commentaires

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com