Función DrvSynchronize (winddi.h)

Artículo
08/27/2023

La función DrvSynchronize informa al controlador de que GDI necesita acceder a una superficie administrada por el dispositivo. Esta función permite coordinar las operaciones de dibujo asincrónicas realizadas por el coprocesador de un dispositivo con accesos GDI.

Sintaxis

void DrvSynchronize(
  DHPDEV dhpdev,
  RECTL  *prcl
);

Parámetros

dhpdev

Controle la estructura PDEV del dispositivo físico que identifica el dispositivo que se va a sincronizar con GDI. Este parámetro es el identificador de dispositivo devuelto a GDI por DrvEnablePDEV.

prcl

Puntero a una estructura RECTL . El controlador debe omitir este parámetro.

Valor devuelto

None

Observaciones

Esta función permite coordinar las operaciones de dibujo asincrónicas realizadas por el coprocesador de un dispositivo con accesos GDI.

DrvSynchronize se puede implementar opcionalmente en controladores de pantalla. GDI llama a esta función solo si está enlazada por EngAssociateSurface. GDI llama a DrvSynchronize justo antes de dibujar directamente en la superficie del dispositivo. GDI llamará a DrvSynchronizeSurface en lugar de DrvSynchronize en controladores que implementan ambas funciones.

Esta función solo debe devolverse cuando sea seguro para que GDI acceda a cualquier superficie administrada por el dispositivo. Es decir, DrvSynchronize debe retrasar la devolución de la llamada hasta que el coprocesador del dispositivo haya completado todas las operaciones de dibujo asincrónicas, lo que indica que es seguro que GDI acceda a cualquier superficie administrada por el dispositivo.

DrvSynchronize está diseñado para admitir dispositivos que usan un coprocesador para dibujar. Este tipo de dispositivo puede tratar algunas operaciones de dibujo como asincrónicas, volviendo a GDI desde la operación antes de que se complete el dibujo. Si este es el caso, es posible que GDI controle una operación de dibujo posterior. Para que GDI acceda de forma segura a las superficies administradas por el dispositivo, debe tener un medio para garantizar que se complete cualquier representación asincrónica realizada por el coprocesador del dispositivo. Al llamar a esta función, GDI sincroniza el acceso a una superficie administrada por el dispositivo con el controlador.

GDI nunca llamará a DrvSynchronize para superficies administradas por dispositivos. DrvSynchronize no es una función de salida.