Compartilhar via


Função DrvDisableSurface (winddi.h)

A função DrvDisableSurface é usada pela GDI para notificar um driver de que a superfície criada por DrvEnableSurface para o dispositivo atual não é mais necessária.

Sintaxe

void DrvDisableSurface(
  DHPDEV dhpdev
);

Parâmetros

dhpdev

Manipule para o PDEV do dispositivo físico. Esse é o identificador do dispositivo cuja superfície deve ser liberada.

Valor retornado

Nenhum

Comentários

O driver deve liberar qualquer memória e recursos usados pela superfície associada ao PDEV assim que o dispositivo físico estiver desabilitado.

Se o driver tiver sido desabilitado por uma chamada para DrvAssertMode, o driver não deverá acessar o hardware durante DrvDisableSurface porque outro PDEV ativo pode estar em uso. Todas as alterações de hardware necessárias devem ter sido executadas durante a chamada para DrvAssertMode. Um driver deve controlar se ele foi desabilitado pelo DrvAssertMode para que possa executar operações de limpeza adequadas no DrvDisableSurface.

Se o dispositivo físico tiver uma superfície habilitada, a GDI chamará DrvDisableSurface antes de chamar DrvDisablePDEV.

DrvDisableSurface é necessário para drivers gráficos.

Requisitos

   
Plataforma de Destino Área de Trabalho
Cabeçalho winddi.h (inclua Winddi.h)

Confira também

DrvAssertMode

DrvDisableDriver

DrvDisablePDEV

DrvEnableSurface