Fonction DrvDisableSurface (winddi.h)

Article
08/27/2023

La fonction DrvDisableSurface est utilisée par GDI pour informer un pilote que la surface créée par DrvEnableSurface pour l’appareil actuel n’est plus nécessaire.

Syntaxe

void DrvDisableSurface(
  DHPDEV dhpdev
);

Paramètres

dhpdev

Gérez le PDEV de l’appareil physique. Il s’agit de la poignée de l’appareil dont la surface doit être libérée.

Valeur de retour

None

Remarques

Le pilote doit libérer la mémoire et les ressources utilisées par la surface associée au PDEV dès que l’appareil physique est désactivé.

Si le pilote a été désactivé par un appel à DrvAssertMode, le pilote ne doit pas accéder au matériel pendant DrvDisableSurface , car un autre PDEV actif peut être utilisé. Toutes les modifications matérielles nécessaires doivent avoir été effectuées pendant l’appel à DrvAssertMode. Un pilote doit vérifier s’il a été désactivé par DrvAssertMode afin qu’il puisse effectuer des opérations de nettoyage appropriées dans DrvDisableSurface.

Si l’appareil physique a une surface activée, GDI appelle DrvDisableSurface avant d’appeler DrvDisablePDEV.

DrvDisableSurface est requis pour les pilotes graphiques.