DDHAL_DDSURFACECALLBACKS

  • Article

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

typedef struct _DDHAL_DDSURFACECALLBACKS
{
DWORD                              dwSize;
DWORD                              dwFlags;
LPDDHALSURFCB_DESTROYSURFACE       DestroySurface;
LPDDHALSURFCB_FLIP                 Flip;
LPDDHALSURFCB_SETCLIPLIST          SetClipList;
LPDDHALSURFCB_LOCK                 Lock;
LPDDHALSURFCB_UNLOCK               Unlock;
LPDDHALSURFCB_BLT                  Blt;
LPDDHALSURFCB_SETCOLORKEY          SetColorKey;
LPDDHALSURFCB_ADDATTACHEDSURFACE   AddAttachedSurface;
LPDDHALSURFCB_GETBLTSTATUS         GetBltStatus;
LPDDHALSURFCB_GETFLIPSTATUS        GetFlipStatus;
LPDDHALSURFCB_UPDATEOVERLAY        UpdateOverlay;
LPDDHALSURFCB_SETOVERLAYPOSITION   SetOverlayPosition;
LPVOID                             reserved4;
LPDDHALSURFCB_SETPALETTE           SetPalette;
} 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 which of the DirectDrawSurface functions are implemented in 32-bit code. One or more of the following flags:

    Flag Usage
    DDHAL_SURFCB32_ADDATTACHEDSURFACE Indicates that the AddAttachedSurface callback is implemented in 32-bit code.
    DDHAL_SURFCB32_BLT Indicates that the Blt callback is implemented in 32-bit code.
    DDHAL_SURFCB32_DESTROYSURFACE Indicates that the DestroySurface callback is implemented in 32-bit code.
    DDHAL_SURFCB32_FLIP Indicates that the Flip callback is implemented in 32-bit code.
    DDHAL_SURFCB32_GETBLTSTATUS Indicates that the GetBltStatus callback is implemented in 32-bit code.
    DDHAL_SURFCB32_ GETFLIPSTATUS Indicates that the GetFlipStatus callback is implemented in 32-bit code.
    DDHAL_SURFCB32_LOCK Indicates that the Lock callback is implemented in 32-bit code.
    DDHAL_SURFCB32_RESERVED4 This flag is reserved for future use.
    DDHAL_SURFCB32_SETCLIPLIST Indicates that the SetClipList callback is implemented in 32-bit code.
    DDHAL_SURFCB32_SETCOLORKEY Indicates that the SetColorKey callback is implemented in 32-bit code.
    DDHAL_SURFCB32_SETOVERLAYPOSITION Indicates that the SetOverlayPosition callback is implemented in 32-bit code.
    DDHAL_SETPALETTE Indicates that the SetPalette callback is implemented in 32-bit code.
    DDHAL_SURFCB32_UNLOCK Indicates that the Unlock callback is implemented in 32-bit code.
    DDHAL_SURFCB32_UPDATEOVERLAY Indicates that the UpdateOverlay callback is implemented in 32-bit code.

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

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

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

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

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

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

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

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

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

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

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

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

  • reserved4
    Reserved for future use.

  • SetPalette
    Pointer to the driver's implementation of the SetPalette callback.

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.

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.