Função DrvSynchronizeSurface (winddi.h)

A função DrvSynchronizeSurface informa ao driver que a GDI precisa gravar na superfície especificada. Essa função permite que as operações de desenho executadas pelo coprocessador de um dispositivo sejam coordenadas com a GDI.

Sintaxe

void DrvSynchronizeSurface(
  SURFOBJ *pso,
  RECTL   *prcl,
  FLONG   fl
);

Parâmetros

pso

Ponteiro para uma estrutura SURFOBJ que identifica a superfície na qual a sincronização de desenho deve ocorrer.

prcl

Especifica uma estrutura RECTL que representa a superfície na qual a GDI desenhará ou NULL. Se isso não colidir com a operação de desenho em andamento, o driver poderá optar por permitir que a GDI desenhe sem esperar que o coprocessador seja concluído.

fl

É um sinalizador que especifica o evento para o qual a GDI está fazendo a solicitação de sincronização. Esse parâmetro pode usar um dos valores a seguir:

DSS_TIMER_EVENT

A GDI está chamando essa função devido a um evento de temporizador de sincronização. Os eventos de temporizador são gerados apenas para os drivers que especificam o bit GCAPS2_SYNCTIMER da estrutura DEVINFO .

DSS_FLUSH_EVENT

A GDI está chamando essa função devido a um evento de liberação de sincronização. Esses eventos de liberação são gerados apenas para os drivers que especificam o bit GCAPS2_SYNCFLUSH da estrutura DEVINFO .

Valor retornado

Nenhum

Comentários

Essa função permite que as operações de desenho executadas pelo coprocessador de um dispositivo sejam coordenadas com a GDI.

DrvSynchronizeSurface pode ser implementado opcionalmente em drivers de vídeo. A GDI chamará essa função somente se ela for conectada por EngAssociateSurface. A GDI chama DrvSynchronizeSurface pouco antes de desenhar diretamente na superfície do dispositivo.

DrvSynchronizeSurface destina-se a dar suporte a dispositivos que usam um coprocessador para desenho. Esse dispositivo pode iniciar uma operação de desenho longa e retornar à GDI enquanto a operação continua. Se o driver do dispositivo não executar todas as operações de desenho na superfície, é possível que uma operação de desenho subsequente seja tratada pela GDI. Nesse caso, é necessário que a GDI aguarde até que o coprocessador conclua seu trabalho antes que a GDI possa desenhar na superfície.

Essa função deve retornar quando for seguro para a GDI desenhar na superfície dentro da região retangular especificada por prcl.

DrvSynchronizeSurface não é uma função de saída.

Requisitos

Confira também

DrvEnablePDEV

DrvSynchronize

EngAssociateSurface