Función DrvDisableSurface (winddi.h)
GDI usa la función DrvDisableSurface para notificar a un controlador que la superficie creada por DrvEnableSurface para el dispositivo actual ya no es necesaria.
Sintaxis
void DrvDisableSurface(
DHPDEV dhpdev
);
Parámetros
dhpdev
Controle el PDEV del dispositivo físico. Este es el identificador del dispositivo cuya superficie se va a liberar.
Valor devuelto
None
Observaciones
El controlador debe liberar cualquier memoria y recursos usados por la superficie asociada al PDEV en cuanto se deshabilite el dispositivo físico.
Si el controlador se ha deshabilitado mediante una llamada a DrvAssertMode, el controlador no debe acceder al hardware durante DrvDisableSurface porque otro PDEV activo podría estar en uso. Los cambios de hardware necesarios deben realizarse durante la llamada a DrvAssertMode. Un controlador debe realizar un seguimiento de si ha sido deshabilitado por DrvAssertMode para que pueda realizar operaciones de limpieza adecuadas en DrvDisableSurface.
Si el dispositivo físico tiene una superficie habilitada, GDI llama a DrvDisableSurface antes de llamar a DrvDisablePDEV.
DrvDisableSurface es necesario para los controladores de gráficos.
Requisitos
Plataforma de destino | Escritorio |
Encabezado | winddi.h (incluya Winddi.h) |