Funzione DrvSynchronizeSurface (winddi.h)
La funzione DrvSynchronizeSurface informa il driver che GDI deve scrivere nella superficie specificata. Questa funzione consente di coordinare le operazioni di disegno eseguite dal coprocessore di un dispositivo con GDI.
Sintassi
void DrvSynchronizeSurface(
SURFOBJ *pso,
RECTL *prcl,
FLONG fl
);
Parametri
pso
Puntatore a una struttura SURFOBJ che identifica la superficie in cui deve essere eseguita la sincronizzazione del disegno.
prcl
Specifica una struttura RECTL che rappresenta la superficie in cui verrà disegnato GDI o NULL. Se questo non è in conflitto con l'operazione di disegno in corso, il conducente può scegliere di lasciare che GDI disegnare senza attendere il completamento del coprocessore.
fl
Flag che specifica l'evento per il quale GDI effettua la richiesta di sincronizzazione. Questo parametro può essere uno dei valori seguenti:
DSS_TIMER_EVENT
GDI chiama questa funzione a causa di un evento timer di sincronizzazione. Gli eventi timer vengono generati solo per i driver che specificano il bit GCAPS2_SYNCTIMER della struttura DEVINFO .
DSS_FLUSH_EVENT
GDI chiama questa funzione a causa di un evento di scaricamento della sincronizzazione. Questi eventi di scaricamento vengono generati solo per i driver che specificano il bit GCAPS2_SYNCFLUSH della struttura DEVINFO .
Valore restituito
nessuno
Osservazioni
Questa funzione consente di coordinare le operazioni di disegno eseguite dal coprocessore di un dispositivo con GDI.
DrvSynchronizeSurface può essere implementato facoltativamente nei driver di visualizzazione. GDI chiama questa funzione solo se è collegato da EngAssociateSurface. GDI chiama DrvSynchronizeSurface appena prima di disegnare direttamente sulla superficie del dispositivo.
DrvSynchronizeSurface è progettato per supportare i dispositivi che usano un coprocessore per il disegno. Un dispositivo di questo tipo può avviare un'operazione di disegno lunga e tornare a GDI mentre l'operazione continua. Se il driver del dispositivo non esegue tutte le operazioni di disegno sulla superficie, è possibile che un'operazione di disegno successiva venga gestita da GDI. In questo caso, è necessario che GDI attenda il completamento del lavoro del coprocessore prima che GDI possa disegnare sulla superficie.
Questa funzione deve restituire quando è sicuro che GDI disegnare sulla superficie all'interno dell'area rettangolare specificata da prcl.
DrvSynchronizeSurface non è una funzione di output.
Requisiti
| Piattaforma di destinazione | Desktop |
| Intestazione | winddi.h (include Winddi.h) |