Função DrvDisableSurface (winddi.h)

Artigo
03/15/2023

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.