Función DrvEnableDirectDraw (winddi.h)

Artículo
08/27/2023

La función DrvEnableDirectDraw habilita el hardware para el uso de DirectDraw.

Sintaxis

BOOL DrvEnableDirectDraw(
  DHPDEV              dhpdev,
  DD_CALLBACKS        *pCallBacks,
  DD_SURFACECALLBACKS *pSurfaceCallBacks,
  DD_PALETTECALLBACKS *pPaletteCallBacks
);

Parámetros

dhpdev

Maneje a la PDEV devuelta por la rutina DrvEnablePDEV del controlador.

pCallBacks

Apunta a la estructura DD_CALLBACKS que el controlador va a inicializar.

pSurfaceCallBacks

Apunta a la estructura DD_SURFACECALLBACKS que el controlador va a inicializar.

pPaletteCallBacks

Apunta a la estructura DD_PALETTECALLBACKS que el controlador va a inicializar.

Valor devuelto

DrvEnableDirectDraw devuelve TRUE si se realiza correctamente; de lo contrario, devuelve FALSE.

Comentarios

GDI llama a la función DrvEnableDirectDraw del controlador para obtener punteros a las devoluciones de llamada de DirectDraw que admite el controlador. El controlador debe establecer los miembros del puntero de función de DD_CALLBACKS, DD_SURFACECALLBACKS y DD_PALETTECALLBACKS para que apunten a las funciones que implementa. Un controlador también debe establecer los campos de bits correspondientes en los miembros dwFlags de estas estructuras para todas las devoluciones de llamada admitidas.

La implementación drvEnableDirectDraw de un controlador también puede dedicar recursos de hardware, como la memoria de visualización para su uso solo por DirectDraw.