VideoPortLogError, fonction (video.h)
La fonction VideoPortLogError journalise les erreurs dans le journal des événements système lorsqu’un pilote miniport détecte une condition d’erreur matérielle pendant les opérations d’E/S.
Syntaxe
VIDEOPORT_API VOID VideoPortLogError(
PVOID HwDeviceExtension,
PVIDEO_REQUEST_PACKET Vrp,
VP_STATUS ErrorCode,
ULONG UniqueId
);
Paramètres
HwDeviceExtension
Pointeur vers l’extension de périphérique du pilote miniport.
Vrp
[facultatif] Pointeur vers une structure [VIDEO_REQUEST_PACKET] qui décrit le paquet de demande vidéo (VRP) s’il est associé à l’erreur ; sinon NULL.
ErrorCode
Spécifie un code d’erreur défini par le pilote miniport qui indique le type d’erreur matérielle.
UniqueId
Spécifie un identificateur unique pour l’erreur. Cette valeur différencie l’erreur actuelle des autres erreurs avec le même ErrorCode. Pour certains pilotes miniports, cela identifie la ligne de code où l’erreur a été détectée ; pour d’autres, il s’agit d’une valeur retournée par le matériel.
Valeur de retour
Aucun
Remarques
Les pilotes miniport doivent appeler VideoPortLogError pour avertir l’utilisateur si le pilote rencontre des erreurs matérielles inhabituelles pendant les opérations normales. La publication de telles erreurs dans le journal des événements système avertit l’utilisateur que la carte vidéo peut échouer afin que l’utilisateur puisse remplacer (ou reconfigurer) l’adaptateur avant qu’une défaillance matérielle totale se produise.
Toutefois, les pilotes miniport doivent pas erreurs de journalisation, telles que « échec de la détection du matériel », qui se produisent fréquemment pendant l’opération normale.
VideoPortLogError peut être appelé à partir d’une fonction HwVidInterrupt ou HwVidSynchronizeExecutionCallback.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 |
| plateforme cible | Bureau |
| d’en-tête | video.h (include Video.h) |
| bibliothèque | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | <= DIRQL |