DrvEnableDirectDraw function (winddi.h)

Article
02/22/2024

The DrvEnableDirectDraw function enables hardware for DirectDraw use.

Syntax

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

Parameters

dhpdev

Handle to the PDEV returned by the driver's DrvEnablePDEV routine.

pCallBacks

Points to the DD_CALLBACKS structure to be initialized by the driver.

pSurfaceCallBacks

Points to the DD_SURFACECALLBACKS structure to be initialized by the driver.

pPaletteCallBacks

Points to the DD_PALETTECALLBACKS structure to be initialized by the driver.

Return value

DrvEnableDirectDraw returns TRUE if it succeeds; otherwise, it returns FALSE.

Remarks

GDI calls the driver's DrvEnableDirectDraw function to obtain pointers to the DirectDraw callbacks that the driver supports. The driver should set the function pointer members of DD_CALLBACKS, DD_SURFACECALLBACKS, and DD_PALETTECALLBACKS to point to those functions that it implements. A driver should also set the corresponding bitfields in the dwFlags members of these structures for all supported callbacks.

A driver's DrvEnableDirectDraw implementation can also dedicate hardware resources such as display memory for use by DirectDraw only.

Requirements

Requirement	Value
Target Platform	Desktop
Header	winddi.h (include Winddi.h)