macro WIAS_ERROR (wiautil.h)
La macro WIAS_ERROR écrit un message de diagnostic dans le fichier Wiatrace.log .
Syntaxe
void WIAS_ERROR(
x
);
Paramètres
x
HInst : gérer la DLL (pilote).
format_string, ... - Spécifie une liste d’arguments variables, qui commence par une chaîne de format ANSI qui décrit le message et les identificateurs de format. Les points de suspension (...) spécifient un nombre variable d’arguments qui doivent être générés. Le texte d’erreur doit être précédé du nom complet de la méthode ou de la fonction et générer le message au format « class ::method, error-text ».
Valeur de retour
None
Remarques
Cette macro est la méthode recommandée pour implémenter la journalisation des erreurs sur Windows Vista, car contrairement à WIAS_LERROR, WIA_ERROR autorise l’écriture des messages d’erreur dans le fichier journal (Wiatrace.log). Le fichier Wiatrace.log est disponible uniquement dans Windows Vista et les versions ultérieures du système d’exploitation. L’utilitaire utilisé pour afficher le contenu de ce fichier journal est WiaTrcVw.exe.
Pour activer le suivi dans les builds gratuites, les pilotes doivent définir la macro WIA_DEBUG en ajoutant #define WIA_DEBUG avant d’inclure les en-têtes WIA. Le suivi est activé par défaut dans les builds vérifiées et de débogage du système d’exploitation.
Voici un exemple d’utilisation de la macro :
WIAS_ERROR((g_hInst, "Failed to read (%ws) entry under %ws section of device registry",REG_ENTRY_STORAGEPATH,REG_ENTRY_DEVICEDATA));
Cet extrait de code a été extrait de Wiadriver.cpp, qui est inclus avec les exemples de pilotes d’acquisition d’images Windows (WIA) sur GitHub.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows Vista et les versions ultérieures du système d’exploitation. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | wiautil.h (inclure Wiautil.h) |