DDHAL_DDSURFACECALLBACKS (Windows CE 5.0)

  • Article

Send Feedback

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

typedef struct _DDHAL_DDSURFACECALLBACKS {DWORDdwSize;DWORDdwFlags;LPDDHALSURFCB_DESTROYSURFACEDestroySurface;LPDDHALSURFCB_FLIPFlip;LPDDHALSURFCB_SETCLIPLISTSetClipList;LPDDHALSURFCB_LOCKLock;LPDDHALSURFCB_UNLOCKUnlock;LPDDHALSURFCB_BLTBlt;LPDDHALSURFCB_SETCOLORKEYSetColorKey;LPDDHALSURFCB_ADDATTACHEDSURFACEAddAttachedSurface;LPDDHALSURFCB_GETBLTSTATUSGetBltStatus;LPDDHALSURFCB_GETFLIPSTATUSGetFlipStatus;LPDDHALSURFCB_UPDATEOVERLAYUpdateOverlay;LPDDHALSURFCB_SETOVERLAYPOSITIONSetOverlayPosition;LPVOIDreserved4;LPDDHALSURFCB_SETPALETTESetPalette;} DDHAL_DDSURFACECALLBACKS;typedef DDHAL_DDSURFACECALLBACKS FAR *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_ADDATTACHEDSURFACE Indicates whether the AddAttachedSurface callback function is implemented.
    DDHAL_SURFCB32_BLT Indicates whether the Blt callback function is implemented.
    DDHAL_SURFCB32_DESTROYSURFACE Indicates whether the DestroySurface callback function is implemented or not.
    DDHAL_SURFCB32_FLIP Indicates whether the Flip callback function is implemented.
    DDHAL_SURFCB32_GETBLTSTATUS Indicates whether the GetBltStatus callback function is implemented.
    DDHAL_SURFCB32_ GETFLIPSTATUS Indicates whether the GetFlipStatus callback function is implemented.
    DDHAL_SURFCB32_LOCK Indicates whether the Lock callback function is implemented.
    DDHAL_SURFCB32_RESERVED4 Reserved for future use.
    DDHAL_SURFCB32_SETCLIPLIST Indicates whether the SetClipList callback function is implemented.
    DDHAL_SURFCB32_SETCOLORKEY Indicates whether the SetColorKey callback function is implemented.
    DDHAL_SURFCB32_SETOVERLAYPOSITION Indicates whether the SetOverlayPosition callback function is implemented.
    DDHAL_SETPALETTE Indicates whether the SetPalette callback function is implemented.
    DDHAL_SURFCB32_UNLOCK Indicates whether the Unlock callback function is implemented.
    DDHAL_SURFCB32_UPDATEOVERLAY Indicates whether the UpdateOverlay callback function is implemented.

  • DestroySurface**
    Pointer to the driver's implementation of the DestroySurface callback function.

  • Flip**
    Pointer to the driver's implementation of the Flip callback function.

  • SetClipList**
    Pointer to the driver's implementation of the SetClipList callback function.

  • Lock**
    Pointer to the driver's implementation of the Lock callback function.

  • Unlock**
    Pointer to the driver's implementation of the Unlock callback function.

  • Blt**
    Pointer to the driver's implementation of the Blt callback function.

  • SetColorKey**
    Pointer to the driver's implementation of the SetColorKey callback function.

  • AddAttachedSurface**
    Pointer to the driver's implementation of the AddAttachedSurface callback function.

  • GetBltStatus**
    Pointer to the driver's implementation of the GetBltStatus callback function.

  • GetFlipStatus**
    Pointer to the driver's implementation of the GetFlipStatus callback function.

  • UpdateOverlay**
    Pointer to the driver's implementation of the UpdateOverlay callback function.

  • SetOverlayPosition**
    Pointer to the driver's implementation of the SetOverlayPosition callback function.

  • reserved4**
    Reserved for future use.

  • SetPalette**
    Pointer to the driver's implementation of the SetPalette 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.

Use the DDHAL_DDMISCELLANEOUS2CALLBACKS structure to expose callback support for IDirectDrawSurface5::AlphaBlt.

Requirements

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header: Ddrawi.h.

See Also

DDHALINFO | AddAttachedSurface | Blt | DestroySurface | Flip | GetBltStatus | GetFlipStatus | Lock | SetClipList | SetColorKey | SetOverlayPosition | SetPalette | Unlock | UpdateOverlay | DDHAL Callback Structures | DDHAL_DDMISCELLANEOUS2CALLBACKS | IDirectDrawSurface5::AlphaBlt

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.