DDHAL_DDCALLBACKS (Compact 2013)

3/26/2014

This structure contains the DirectDraw callback functions. It is included in the DDHALINFO structure.

Syntax

typedef struct _DDHAL_DDCALLBACKS {
  DWORD dwSize;
  DWORD dwFlags;
  LPDDHAL_CREATESURFACE CreateSurface;
  LPDDHAL_WAITFORVERTICALBLANK WaitForVerticalBlank;
  LPDDHAL_CANCREATESURFACE CanCreateSurface;
  LPDDHAL_CREATEPALETTE CreatePalette;
  LPDDHAL_GETSCANLINE GetScanLine;
} DDHAL_DDCALLBACKS;
typedef DDHAL_DDCALLBACKS FAR *LPDDHAL_DDCALLBACKS;

Members

• dwSize
  Size of the structure. This parameter must be initialized before the structure is used.

• dwFlags
  Indicates whether the DirectDraw functions are implemented.

  The following table shows the possible flags.

  Flag	Description
  DDHAL_CB32_CANCREATESURFACE	Indicates whether the LPDDHAL_CANCREATESURFACE callback function is implemented.
  DDHAL_CB32_CREATESURFACE	Indicates whether the LPDDHAL_CREATESURFACE callback function is implemented.
  DDHAL_CB32_GETSCANLINE	Indicates whether the LPDDHAL_GETSCANLINE callback function is implemented.
  DDHAL_CB32_WAITFORVERTICALBLANK	Indicates whether the LPDDHAL_WAITFORVERTICALBLANK callback function is implemented.

• CreateSurface
  Pointer to the driver's implementation of the LPDDHAL_CREATESURFACE callback function.

• WaitForVerticalBlank
  Pointer to the driver's implementation of the LPDDHAL_WAITFORVERTICALBLANK callback function.

• CanCreateSurface
  Pointer to the driver's implementation of the LPDDHAL_CANCREATESURFACE callback function.

• CreatePalette
  Unsupported. Must be set to NULL.

• GetScanLine
  Pointer to the driver's implementation of the LPDDHAL_GETSCANLINE callback function.

Remarks

This structure contains the entry points in the display driver that DirectDraw calls. Entries that the display driver does not use should be set to NULL.

Requirements

Header

ddrawi.h

See Also

Reference

DDHAL Callback Structures
DDHALINFO
LPDDHAL_CANCREATESURFACE
LPDDHAL_CREATESURFACE
LPDDHAL_GETSCANLINE
LPDDHAL_WAITFORVERTICALBLANK