Funzione DrvDisableSurface (winddi.h)

Articolo
03/15/2023

La funzione DrvDisableSurface viene usata da GDI per notificare a un driver che la superficie creata da DrvEnableSurface per il dispositivo corrente non è più necessaria.

Sintassi

void DrvDisableSurface(
  DHPDEV dhpdev
);

Parametri

dhpdev

Gestire il PDEV del dispositivo fisico. Si tratta dell'handle del dispositivo la cui superficie deve essere rilasciata.

Valore restituito

nessuno

Osservazioni

Il driver deve liberare qualsiasi memoria e risorse usate dalla superficie associata al PDEV non appena il dispositivo fisico è disabilitato.

Se il driver è stato disabilitato da una chiamata a DrvAssertMode, il driver non deve accedere all'hardware durante DrvDisableSurface perché un altro PDEV attivo potrebbe essere in uso. Tutte le modifiche hardware necessarie devono essere state eseguite durante la chiamata a DrvAssertMode. Un driver deve tenere traccia del fatto che sia stato disabilitato da DrvAssertMode in modo che possa eseguire operazioni di pulizia appropriate in DrvDisableSurface.

Se il dispositivo fisico ha una superficie abilitata, GDI chiama DrvDisableSurface prima di chiamare DrvDisablePDEV.

DrvDisableSurface è necessario per i driver grafici.