Vous êtes actuellement hors ligne, en attente de reconnexion à Internet.

COMMENT FAIRE: activer l'enregistrement dans Wiadebug.log

Le support de Windows XP a pris fin

Microsoft a mis fin au support de Windows XP le 8 avril 2014. Cette modification a affecté vos mises à jour logicielles et options de sécurité. Découvrez les implications de ce changement à votre niveau et la marche à suivre pour rester protégé.

Ancien nº de publication de cet article : F307001
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.

retour en haut de la page

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.

retour en haut de la page

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.

retour en haut de la page


Propriétés

ID d'article : 307001 - Dernière mise à jour : 04/30/2003 16:12:00 - Révision : 1.0

  • Microsoft Windows XP Professionnel
  • kbhowto kbhowtomaster kbtool KB307001
Commentaires