VideoPortRegisterBugcheckCallback, fonction (video.h)

La fonction VideoPortRegisterBugcheckCallback permet à un pilote de miniport vidéo de s’inscrire à un rappel appelé lorsqu’un bogue spécifié case activée se produit.

Syntaxe

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortRegisterBugcheckCallback(
  [in] IN PVOID                    HwDeviceExtension,
  [in] IN ULONG                    BugcheckCode,
  [in] IN PVIDEO_BUGCHECK_CALLBACK Callback,
  [in] IN ULONG                    BugcheckDataSize
);

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique du pilote miniport.

[in] BugcheckCode

Indique le bogue case activée code pour lequel être rappelé. Actuellement, le pilote miniport peut s’inscrire uniquement pour les 0xEA de code de case activée de bogues.

[in] Callback

Pointeur vers la fonction HwVidBugcheckCallback du pilote miniport. Cette fonction doit être non paginée et ne doit pas faire référence à du code paginable ou à des données. Le pilote miniport peut définir ce paramètre sur NULL pour indiquer que le bogue case activée rappel doit être déconnecté.

[in] BugcheckDataSize

Indique la somme des BUGCHECK_DATA_SIZE_RESERVED et le nombre d’octets de données que le pilote miniport fournira pour inclusion dans le fichier de vidage. La valeur de ce paramètre doit être inférieure ou égale à 4000. Le pilote miniport peut définir ce paramètre sur zéro pour indiquer que le bogue case activée rappel doit être déconnecté.

Valeur retournée

VideoPortRegisterBugcheckCallback retourne NO_ERROR si elle réussit. Sinon, elle retourne un code status indiquant la nature de l’échec.

Remarques

Si vous développez un pilote de miniport vidéo destiné à s’exécuter sur Windows XP ou un système d’exploitation NT antérieur, vous pouvez utiliser la routine de rappel VideoPortGetProcAddress pour rechercher l’adresse de la fonction VideoPortRegisterBugcheckCallback . Pour plus d’informations, consultez Utilisation de VideoPortGetProcAddress.

Un pilote miniport peut s’inscrire à un rappel lorsqu’un type spécifique de case activée de bogue se produit. Actuellement, seules les 0xEA de code de case activée de bogues peuvent être accrochées. Lorsque le bogue case activée se produit, la fonction de rappel fournie par minidriver est appelée et le pilote miniport peut ajouter des données au fichier de vidage. Cela est utile pour collecter des données statistiques lorsque le débogage direct n’est pas possible.

La valeur du paramètre BugcheckDataSize doit être BUGCHECK_DATA_SIZE_RESERVED octets supérieurs aux données fournies par le pilote miniport. Par exemple, supposons que le pilote miniport fournisse DUMP_SIZE octets de données à écrire dans le fichier de vidage. Ensuite, la valeur de BugcheckDataSize doit être DUMP_SIZE + BUGCHECK_DATA_SIZE_RESERVED, et cette valeur totale doit être inférieure ou égale à 4 000.

La constante BUGCHECK_DATA_SIZE_RESERVED (définie dans video.h) est disponible dans les environnements de build Microsoft Windows Server 2003 et ultérieur. Dans l’environnement de build Windows XP SP1, utilisez 48 au lieu de BUGCHECK_DATA_SIZE_RESERVED.

Le pilote miniport peut annuler l’inscription d’un rappel précédemment inscrit en appelant cette fonction, en spécifiant NULL pour le paramètre Callback ou zéro pour le paramètre DataSize .

Pour plus d’informations, consultez Prise en charge du pilote de port vidéo pour les rappels de vérification des bogues.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows XP SP1 et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	video.h (incluez Video.h)
Bibliothèque	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL

Voir aussi

HwVidBugcheckCallback