PVIDEO_BUGCHECK_CALLBACK fonction de rappel (video.h)
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 se composer de plusieurs pilotes miniport vidéo, les fournisseurs 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) |