macro WIAS_ASSERT (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 n’importe quelle expression logique.
y
Handle to the DLL (driver).
Valeur de retour
Aucun
Remarques
La macro WIAS_ASSERT est utilisée pour déboguer les pilotes WIA. Il est utilisé pour tester 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 d’accès au pilote appelant et 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 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 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 vérifiées et de débogage du système d’exploitation.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | wiamdef.h (include Wiautil.h) |