Fonction DrvAssertMode (winddi.h)

  • Article

La fonction DrvAssertMode définit le mode de l’appareil physique spécifié sur le mode spécifié lors de l’initialisation du PDEV ou sur le mode par défaut du matériel.

Syntaxe

BOOL DrvAssertMode(
  [in] DHPDEV dhpdev,
  [in] BOOL   bEnable
);

Paramètres

[in] dhpdev

Handle to the PDEV décrivant le mode matériel qui doit être défini lorsque bEnable a la valeur TRUE.

[in] bEnable

Spécifie le mode sur lequel le matériel doit être défini. Si ce paramètre a la valeur TRUE, le pilote doit définir le matériel sur le mode d’origine spécifié par le PDEV initialisé. Sinon, si ce paramètre a la valeur FALSE, le pilote doit définir le mode par défaut du matériel afin que le pilote de miniport vidéo puisse prendre le contrôle.

Valeur retournée

DrvAssertMode retourne TRUE s’il a correctement modifié le mode d’affichage ; elle retourne FALSE s’il n’a pas pu modifier le mode d’affichage. Un pilote est autorisé à retourner FALSE à partir d’un appel DrvAssertMode avec bEnable défini sur FALSE. Un pilote doit retourner TRUE à partir d’un appel DrvAssertMode avec bEnable défini sur TRUE ; Autrement dit, un pilote ne peut pas échouer à activer un mode précédemment activé.

Remarques

GDI appelle DrvAssertMode lorsqu’il est nécessaire de basculer entre plusieurs bureaux sur une même surface d’affichage. Pour basculer d’un PDEV à un autre, GDI appelle DrvAssertMode avec le paramètre bEnable défini sur FALSE pour un PDEV et TRUE pour l’autre. Pour revenir au PDEV d’origine, DrvAssertMode est appelé avec bEnable défini sur FALSE, suivi d’un autre appel à DrvAssertMode, avec bEnable défini sur TRUE et dhpdev défini sur le PDEV d’origine.

Si l’appareil physique est géré par palette, GDI appelle DrvSetPalette pour réinitialiser la palette de l’appareil. Le pilote n’a ensuite pas besoin de suivre l’état actuel du pointeur, car le Gestionnaire de fenêtres sélectionne la forme de pointeur appropriée et la déplace vers la position actuelle. Le gestionnaire de consoles garantit que les bureaux sont correctement redessinés.

DrvAssertMode doit être implémenté dans les pilotes d’affichage.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête winddi.h (inclure Winddi.h)

Voir aussi

DrvGetModes

DrvSetPalette