Fonction VideoPortLogError (video.h)

Article
02/27/2024

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

Condition requise	Valeur
Client minimal pris en charge	Windows 2000
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	video.h (inclure Video.h)
Bibliothèque	Videoprt.lib
DLL	Videoprt.sys
IRQL	<= DIRQL

Voir aussi

VideoDebugPrint

Partager via