PVIDEO_HW_RESET_HW fonction de rappel (video.h)

Article
02/29/2024

HwVidResetHw réinitialise l’adaptateur en mode caractère.

Syntaxe

PVIDEO_HW_RESET_HW PvideoHwResetHw;

BOOLEAN PvideoHwResetHw(
  PVOID HwDeviceExtension,
  ULONG Columns,
  ULONG Rows
)
{...}

Paramètres

HwDeviceExtension

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

Columns

Spécifie le nombre de colonnes du mode à configurer.

Rows

Spécifie le nombre de lignes du mode à configurer.

Valeur retournée

HwVidResetHw doit retourner TRUE s’il réinitialise complètement l’adaptateur en mode caractère donné. Sinon, elle doit retourner FALSE pour indiquer que hal doit effectuer l’équivalent d’un appel BIOS de type MODE3 INT10 après que HwVidResetHw retourne le contrôle.

Remarques

Un pilote miniport vidéo doit avoir une fonction HwVidResetHw si son adaptateur ne peut pas être réinitialisé à un état entièrement initialisé sans démarrage dur de la machine. Par exemple, si le code d’initialisation rom de l’adaptateur ne peut pas réinitialiser l’état de l’adaptateur en mode de démarrage, le pilote miniport doit avoir une fonction HwVidResetHw . Une autre raison pour laquelle le pilote miniport doit implémenter cette fonction est de propre les lignes d’interruption de l’adaptateur lorsque l’adaptateur est hors tension, évitant ainsi un déluge d’interruptions lors du prochain démarrage du système.

Le HAL appelle HwVidResetHw si le système est sur le point de se bloquer, afin que hal puisse afficher des informations sur l’écran pendant l’arrêt du système. Cet appel peut se produire à n’importe quel IRQL, et le pilote doit être prêt à le gérer à tout moment. Hal appelle également HwVidResetHw juste avant le redémarrage de l’ordinateur lorsqu’un démarrage en douceur se produit.

La plupart des pilotes miniport doivent fournir cette fonction, à l’exception des pilotes d’adaptateurs qui sont réinitialisés en mode caractère standard VGA à la réception d’une commande de type INT10, MODE3.

HwVidResetHw réinitialise l’adaptateur en mode caractère, en fonction des valeurs Columns et Rows spécifiées . Toutefois, étant donné que le système s’arrête, HwVidResetHw ne peut pas appeler le BIOS ou tout code paginable. HwVidResetHw doit appeler uniquement les fonctions VideoPortRead/WritePortXxx et/ou VideoPortRead/WriteRegisterXxx . (Consultez Fonctions exportées par le pilote de port vidéo.)

Si HwVidResetHw ne peut pas modifier le mode de l’adaptateur en programmant simplement les registres de l’adaptateur, il peut configurer les valeurs appropriées dans les registres d’adaptateurs et retourner FALSE. Cela entraîne l’exécution d’une opération étendue de type INT10 pour réinitialiser la carte vidéo en mode caractère.

HwVidResetHw ne doit pas appeler VideoPortInt10. La fonction HwVidStartIO d’un pilote miniport est appelée avec le IOCTL_VIDEO_RESET_DEVICE VRP pour réinitialiser l’adaptateur chaque fois que le programme Display est utilisé pour tester ou modifier le mode d’affichage graphique, et non la fonction HwVidResetHw du pilote miniport.

HwVidResetHw ne doit pas être rendu paginable.