VideoPortRegisterBugcheckCallback, fonction (video.h)

La fonction VideoPortRegisterBugcheckCallback permet à un pilote de miniport vidéo de s’inscrire ou de hook, un rappel appelé lorsqu’une vérification de bogue spécifié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 code de vérification des bogues pour lequel être rappelé. Actuellement, le pilote miniport peut s’inscrire uniquement pour le code de vérification des bogues 0xEA.

[in] Callback

Pointeur vers la fonction HwVidBugcheckCallback du pilote miniport. Cette fonction doit être non paginée et ne doit pas référencer de code ou de données paginables. Le pilote miniport peut définir ce paramètre sur null pour indiquer que le rappel de vérification des bogues doit être déconnecté.

[in] BugcheckDataSize

Indique la somme de 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 à 4 000. Le pilote miniport peut définir ce paramètre sur zéro pour indiquer que le rappel de vérification des bogues doit être déconnecté.

Valeur de retour

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

Remarques

Si vous développez un pilote miniport vidéo destiné à s’exécuter sur Windows XP ou un système d’exploitation de base 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 vérification de bogue se produit. Actuellement, seul code de vérification des bogues 0xEA peut être connecté. Lorsque la vérification des bogues 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 fournit 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érieurs. 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 de rappel, ou zéro pour le paramètre DataSize.

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

Exigences

Voir aussi

HwVidBugcheckCallback