WIAS_ASSERT macro (wiamdef.h)
La macro WIAS_ASSERT écrit un message de diagnostic dans le fichier Wiatrace.log .
Syntaxe
void WIAS_ASSERT(
x,
y
);
Paramètres
x
Spécifie toute expression logique.
y
Handle vers la DLL (pilote).
Valeur de retour
None
Remarques
La macro WIAS_ASSERT est utilisée pour déboguer les pilotes WIA. Il est utilisé pour vérifier qu’une certaine condition est remplie. Si le paramètre Expression prend la valeur TRUE, cette macro ne fait rien. Si Expression prend la valeur FALSE, la macro imprime une chaîne d’erreur dans le fichier journal de diagnostic Wiatrace.log . Ce message d’erreur contient le nom et le chemin du pilote appelant, ainsi que le numéro de ligne dans le code source du pilote où la macro WIAS_ASSERT a échoué.
La macro WIAS_ASSERT est disponible dans Windows Vista et les versions ultérieures du système d’exploitation. Cette macro est la méthode recommandée pour implémenter des assertions WIA sur Windows Vista. WIAS_ASSERT permet d’écrire les 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 les assertions dans les builds gratuites, les pilotes doivent définir la macro WIA_DEBUG en ajoutant #define WIA_DEBUG au code source du pilote ; cette opération doit être effectuée avant d’inclure l’un des en-têtes WIA. Les assertions sont activées par défaut dans les builds cochées et déboguées du système d’exploitation.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | wiamdef.h (incluez Wiautil.h) |