 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
The DDHAL_DDSURFACECALLBACKSstructure contains the surface callback functions used by the driver. This structure is part of the DDHALINFOstructure.
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
DirectDrawSurfacefunctions are implemented in 32-bit code.
One or more of the following flags:
Flag Usage DDHAL_SURFCB32_ADDATTACHEDSURFACE Indicates that the AddAttachedSurfacecallback is implemented in 32-bit code. DDHAL_SURFCB32_BLT Indicates that the Bltcallback is implemented in 32-bit code. DDHAL_SURFCB32_DESTROYSURFACE Indicates that the DestroySurfacecallback is implemented in 32-bit code. DDHAL_SURFCB32_FLIP Indicates that the Flipcallback is implemented in 32-bit code. DDHAL_SURFCB32_GETBLTSTATUS Indicates that the GetBltStatuscallback is implemented in 32-bit code. DDHAL_SURFCB32_ GETFLIPSTATUS Indicates that the GetFlipStatuscallback is implemented in 32-bit code. DDHAL_SURFCB32_LOCK Indicates that the Lockcallback is implemented in 32-bit code. DDHAL_SURFCB32_RESERVED4 This flag is reserved for future use. DDHAL_SURFCB32_SETCLIPLIST Indicates that the SetClipListcallback is implemented in 32-bit code. DDHAL_SURFCB32_SETCOLORKEY Indicates that the SetColorKeycallback is implemented in 32-bit code. DDHAL_SURFCB32_SETOVERLAYPOSITION Indicates that the SetOverlayPositioncallback is implemented in 32-bit code. DDHAL_SETPALETTE Indicates that the SetPalettecallback is implemented in 32-bit code. DDHAL_SURFCB32_UNLOCK Indicates that the Unlockcallback is implemented in 32-bit code. DDHAL_SURFCB32_UPDATEOVERLAY Indicates that the UpdateOverlaycallback is implemented in 32-bit code. - DestroySurface
- Pointer to the driver's implementation of the DestroySurfacecallback.
- Flip
- Pointer to the driver's implementation of the Flipcallback.
- SetClipList
- Pointer to the driver's implementation of the SetClipListcallback.
- Lock
- Pointer to the driver's implementation of the Lockcallback.
- Unlock
- Pointer to the driver's implementation of the Unlockcallback.
- Blt
- Pointer to the driver's implementation of the Bltcallback.
- SetColorKey
- Pointer to the driver's implementation of the SetColorKeycallback.
- AddAttachedSurface
- Pointer to the driver's implementation of the AddAttachedSurfacecallback.
- GetBltStatus
- Pointer to the driver's implementation of the GetBltStatuscallback.
- GetFlipStatus
- Pointer to the driver's implementation of the GetFlipStatuscallback.
- UpdateOverlay
- Pointer to the driver's implementation of the UpdateOverlaycallback.
- SetOverlayPosition
- Pointer to the driver's implementation of the SetOverlayPositioncallback.
- reserved4
- Reserved for future use.
- SetPalette
- Pointer to the driver's implementation of the
SetPalettecallback.
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