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
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | winddi.h (inclua Winddi.h) |