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

Voir aussi

WIAS_ASSERT

WIAS_HRESULT

WIAS_TRACE