Compartir a través de


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)

Consulte también

DrvAssertMode

DrvDisableDriver

DrvDisablePDEV

DrvEnableSurface