Funzione DrvSynchronize (winddi.h)

Articolo
08/27/2023

La funzione DrvSynchronize informa il driver che GDI deve accedere a una superficie gestita dal dispositivo. Questa funzione consente di coordinare le operazioni di disegno asincrone eseguite dal coprocessore di un dispositivo con gli accessi GDI.

Sintassi

void DrvSynchronize(
  DHPDEV dhpdev,
  RECTL  *prcl
);

Parametri

dhpdev

Gestire la struttura PDEV del dispositivo fisico che identifica il dispositivo da sincronizzare con GDI. Questo parametro è l'handle del dispositivo restituito a GDI da DrvEnablePDEV.

prcl

Puntatore a una struttura RECTL . Questo parametro deve essere ignorato dal driver.

Valore restituito

nessuno

Osservazioni

Questa funzione consente di coordinare le operazioni di disegno asincrone eseguite dal coprocessore di un dispositivo con gli accessi GDI.

DrvSynchronize può essere implementato facoltativamente nei driver di visualizzazione. GDI chiama questa funzione solo se è collegato da EngAssociateSurface. GDI chiama DrvSynchronize appena prima di disegnare direttamente nell'area del dispositivo. GDI chiamerà DrvSynchronizeSurface anziché DrvSynchronize nei driver che implementano entrambe queste funzioni.

Questa funzione deve restituire solo quando è sicuro che GDI possa accedere a qualsiasi superficie gestita dal dispositivo. Ovvero, DrvSynchronize deve ritardare la restituzione dalla chiamata fino a quando tutte le operazioni di disegno asincrone sono state completate dal coprocessore del dispositivo, indicando così che è sicuro che GDI possa accedere a qualsiasi superficie gestita dal dispositivo.

DrvSynchronize è destinato a supportare i dispositivi che usano un coprocessore per il disegno. Tale dispositivo può trattare alcune operazioni di disegno come asincrone, restituendo a GDI dall'operazione prima del completamento del disegno. In questo caso, è possibile che un'operazione di disegno successiva venga gestita da GDI. Per consentire a GDI di accedere in modo sicuro alle superfici gestite dal dispositivo, deve disporre di un mezzo per garantire che il rendering asincrono eseguito dal coprocessore del dispositivo sia completato. Chiamando questa funzione, GDI sincronizza l'accesso a una superficie gestita dal dispositivo con il driver.

GDI non chiamerà mai DrvSynchronize per le superfici gestite dal dispositivo. DrvSynchronize non è una funzione di output.