Expand Minimize

DD_CALLBACKS structure

The DD_CALLBACKS structure contains entry pointers to the callback functions that a device driver supports.

Syntax


typedef struct DD_CALLBACKS {
  DWORD                    dwSize;
  DWORD                    dwFlags;
  PDD_DESTROYDRIVER        DestroyDriver;
  PDD_CREATESURFACE        CreateSurface;
  PDD_SETCOLORKEY          SetColorKey;
  PDD_SETMODE              SetMode;
  PDD_WAITFORVERTICALBLANK WaitForVerticalBlank;
  PDD_CANCREATESURFACE     CanCreateSurface;
  PDD_CREATEPALETTE        CreatePalette;
  PDD_GETSCANLINE          GetScanLine;
  PDD_MAPMEMORY            MapMemory;
} DD_CALLBACKS;

Members

dwSize

Specifies the size in bytes of this structure.

dwFlags

Indicates what Microsoft DirectDraw callback functions the driver has implemented. For every bit set in dwFlags, the driver must initialize the corresponding function pointer member of this structure. This member can be one or more of the following flags:

DDHAL_CB32_CANCREATESURFACE
DDHAL_CB32_CREATEPALETTE
DDHAL_CB32_CREATESURFACE
DDHAL_CB32_GETSCANLINE
DDHAL_CB32_MAPMEMORY
DDHAL_CB32_SETCOLORKEY
DDHAL_CB32_SETMODE
DDHAL_CB32_WAITFORVERTICALBLANK
DestroyDriver

Unused on Microsoft Windows 2000 and later and should be ignored by the driver.

CreateSurface

Points to the driver-supplied DdCreateSurface callback.

SetColorKey

Points to the driver-supplied DdSetColorKey callback.

SetMode

Unused on Windows 2000 and later and should be ignored by the driver.

WaitForVerticalBlank

Points to the driver-supplied DdWaitForVerticalBlank callback.

CanCreateSurface

Points to the driver-supplied DdCanCreateSurface callback.

CreatePalette

Points to the driver-supplied DdCreatePalette callback.

GetScanLine

Points to the driver-supplied DdGetScanLine callback.

MapMemory

Points to the driver-supplied DdMapMemory callback.

Remarks

Entries that the display driver does not use should be set to NULL. GDI allocates the memory for this structure and calls the driver's DrvEnableDirectDraw function to initialize it.

Requirements

Header

Ddrawint.h (include Winddi.h)

See also

DD_COLORCONTROLCALLBACKS
DD_KERNELCALLBACKS
DD_MISCELLANEOUSCALLBACKS
DD_MOTIONCOMPCALLBACKS
DD_NTCALLBACKS
DD_PALETTECALLBACKS
DD_SURFACECALLBACKS
DD_VIDEOPORTCALLBACKS
DrvEnableDirectDraw

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft