Fonction VideoPortLogError (video.h)

La fonction VideoPortLogError consigne 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 requête 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 miniport, 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

None

Remarques

Les pilotes miniport doivent appeler VideoPortLogError pour informer l’utilisateur si le pilote rencontre des erreurs matérielles inhabituelles pendant des 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 ne se produise.

Toutefois, les pilotes miniport ne doivent pas consigner les erreurs, telles que « échec de la détection du matériel », qui se produisent fréquemment pendant un fonctionnement normal.

VideoPortLogError peut être appelé à partir de la fonction HwVidInterrupt ou HwVidSynchronizeExecutionCallback d’un pilote miniport.

Configuration requise

Voir aussi

VideoDebugPrint