Share via

DDHAL_DDSURFACECALLBACKS (Compact 2013)

  • Article

3/26/2014

This structure contains the surface callback functions used by the driver and is part of the DDHALINFO DirectDraw structure.

Syntax

typedef struct _DDHAL_DDSURFACECALLBACKS {
  DWORD dwSize;
  DWORD dwFlags;
  LPDDHALSURFCB_DESTROYSURFACE DestroySurface;
  LPDDHALSURFCB_FLIP Flip;
  LPDDHALSURFCB_LOCK Lock;
  LPDDHALSURFCB_UNLOCK Unlock;
  LPDDHALSURFCB_SETCOLORKEY SetColorKey;
  LPDDHALSURFCB_GETBLTSTATUS GetBltStatus;
  LPDDHALSURFCB_GETFLIPSTATUS GetFlipStatus;
  LPDDHALSURFCB_UPDATEOVERLAY UpdateOverlay;
  LPDDHALSURFCB_SETOVERLAYPOSITION SetOverlayPosition;
  LPDDHALSURFCB_SETPALETTE SetPalette;
} DDHAL_DDSURFACECALLBACKS,* LPDDHAL_DDSURFACECALLBACKS;

Members

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

  • dwFlags
    Indicates whether the DirectDrawSurface functions are implemented. One or more of the following flags.

    The following table shows the possible flags.

    Flag

    Description

    DDHAL_SURFCB32_DESTROYSURFACE

    Indicates whether the LPDDHAL_DESTROYSURFACE callback function is implemented or not.

    DDHAL_SURFCB32_FLIP

    Indicates whether the LPDDHALSURFCB_FLIP callback function is implemented.

    DDHAL_SURFCB32_GETBLTSTATUS

    Indicates whether the LPDDHALSURFCB_GETBLTSTATUS callback function is implemented.

    DDHAL_SURFCB32_ GETFLIPSTATUS

    Indicates whether the LPDDHALSURFCB_GETFLIPSTATUS callback function is implemented.

    DDHAL_SURFCB32_LOCK

    Indicates whether the LPDDHALSURFCB_LOCK callback function is implemented.

    DDHAL_SURFCB32_SETOVERLAYPOSITION

    Indicates whether the LPDDHALSURFCB_SETOVERLAYPOSITION callback function is implemented.

    DDHAL_SURFCB32_SETCOLORKEY

    Indicates whether the LPDDHALSURFCB_SETCOLORKEY callback function is implemented.

    DDHAL_SURFCB32_UNLOCK

    Indicates whether the LPDDHALSURFCB_UNLOCK callback function is implemented.

    DDHAL_SURFCB32_UPDATEOVERLAY

    Indicates whether the LPDDHALSURFCB_UPDATEOVERLAY callback function is implemented.
  • Flip
    Pointer to the driver's implementation of the LPDDHALSURFCB_FLIP callback function.
  • Lock
    Pointer to the driver's implementation of the LPDDHALSURFCB_LOCK callback function.
  • SetPalette
    Unsupported. This member must be set to NULL.

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