PVIDEO_BUGCHECK_CALLBACK fonction de rappel (video.h)

  • Article

La fonction HwVidBugcheckCallback permet au pilote miniport d’ajouter des données à un fichier de vidage lorsqu’un bogue case activée se produit.

Syntaxe

PVIDEO_BUGCHECK_CALLBACK PvideoBugcheckCallback;

void PvideoBugcheckCallback(
  [in] IN PVOID HwDeviceExtension,
  [in] IN ULONG BugcheckCode,
  [in] IN PUCHAR Buffer,
  [in] IN ULONG BufferSize
)
{...}

Paramètres

[in] HwDeviceExtension

Pointeur vers la zone de stockage par adaptateur du pilote miniport. Pour plus d’informations, consultez Extensions d’appareil.

[in] BugcheckCode

Spécifie un code de case activée de bogue.

[in] Buffer

Pointeur vers l’emplacement de mémoire où le pilote miniport peut stocker les données qui doivent être ajoutées au fichier de vidage.

[in] BufferSize

Spécifie la taille, en octets, de la mémoire tampon pointée vers le paramètre Buffer .

Valeur de retour

None

Remarques

Cette fonction est disponible dans Windows XP SP1 et versions ultérieures.

Cette fonction est appelée lorsqu’un bogue case activée se produit. Le pilote miniport peut collecter des données qui doivent être ajoutées au fichier de vidage et écrire ces données dans la mémoire tampon. Le pilote ne doit pas écrire plus d’octets BufferSize dans la mémoire tampon.

Un pilote de miniport vidéo inscrit la fonction HwVidBugcheckCallback en appelant la fonction VideoPortRegisterBugcheckCallback . La fonction VideoPortRegisterBugcheckCallback expose ce rappel fourni par le pilote de miniport vidéo au système.

Pour faciliter la récupération du système après un bogue case activée, tous les registres auxquels cette fonction accède ne doivent pas entraver la capacité du matériel à passer en mode de secours, quel que soit l’état de l’appareil. En outre, la fonction doit retourner le contrôle à son appelant.

Étant donné qu’un système peut être constitué de plusieurs pilotes de miniport vidéo, les distributeurs doivent ajouter une chaîne d’identification aux données que cette fonction ajoute au fichier de vidage.

La fonction est appelée au niveau de l’IRQL élevé et ne doit pas tenter d’accéder à du code paginable ou à des données.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête video.h (incluez Video.h)

Voir aussi

VideoPortRegisterBugcheckCallback