|
|
/*==========================================================================;
* * Copyright (C) 1994-1996 Microsoft Corporation. All Rights Reserved. * * File: ddraw.h * Content: DirectDraw include file *@@BEGIN_MSINTERNAL * History: * Date By Reason * ==== == ====== * 24-dec-94 craige initial implementation * 13-jan-95 craige updated * 31-jan-95 craige and even more ongoing work... * 01-mar-95 craige flags with Get/SetExclusiveMode * 07-mar-95 craige FourCC code stuff * 08-mar-95 craige blt/overlay stretch distinction, bunch of new APIs * 11-mar-95 craige palette stuff * 17-mar-95 craige COM interface * 20-mar-95 craige Get/SetExclusiveMode->Get/SetExclusiveModeOwner, * flags with CreateSurface and DuplicateSurface * 28-mar-95 craige removed Get/SetColorKey, added FlipToGDISurface to * IDirectDraw; switched to PALETTEENTRY from RGBQUAD * 01-apr-95 craige happy fun joy updated header file THANK YOU ERIC * 06-apr-95 craige added dwVidMemTotal, dwVidMemFree to DDCAPS * 13-apr-95 craige EricEng's little contribution to our being late * 15-apr-95 craige GetBltStatus, added flag to GetFlipStatus * 12-may-95 craige added GUIDS;DirectDrawEnumerate * 19-may-95 craige added DDSEMO_ALLOWREBOOT * 23-may-95 craige have driver GetCaps return HEL caps; added Flush, * GetBatchLimit, SetBatchLimit to IDirectDraw * 24-may-95 kylej removed obsolete ZOrder variables * 24-may-95 craige added Restore * 28-may-95 craige added DDCAPS_COLORKEY_HWASSIST; Unicode support * 04-jun-95 craige added IsLost * 05-jun-95 craige removed GetVersion, FreeAllSurfaces, DefWindowProc; * change GarbageCollect to Compact * 06-jun-95 craige removed GetExclusiveModeOwner; added parm to * SetExclusiveMode * 15-jun-95 craige new surface interfaces: IDirectDrawSurfaceNotification, * IDirectDrawSurfaceComposition * 19-jun-95 craige rationalized INVALIDxxx to DDERR_INVALIDOBJECT * 20-jun-95 kylej added DDERR_CANNOTDETACHSURFACE * 21-jun-95 craige added DirectDrawClipper object; removed clipping * info from surface object * 24-jun-95 craige added DDBLTFAST_xxx flags * 27-jun-95 craige removed Flush,Set/GetBatchLimit; added BltBatch * 30-jun-95 kylej added DDERR_INCOMPATIBLEPRIMARY * 30-jun-95 craige added dest align as well as src * 01-jul-95 craige hide composition & streaming stuff; added DDERR_EXCEPTION * 02-jul-95 craige hide clipper notification stuff; futzed with DDSCAPS * position in structures * 03-jul-95 kylej changed EnumSurfaces declaration * 03-jul-95 craige added pUnkOuter to all Create fns; added object ptr * to CreateSurface, removed lpClipList and lpDDSurface * from surface desc. * 05-jul-95 craige added Initialize members to all interfaces to allow * for full COM integration * 09-jul-95 craige added DDERR_LOCKEDSURFACES; changed SetExclusiveMode * to SetCooperativeLevel * 10-jul-95 kylej added mirroring caps and overlay FX flags * 12-jul-95 craige added DDSCAPS_OWNDC * 13-jul-95 craige changed Get/SetOverlayPosition to take LONGs * 14-jul-95 craige added dwFlags to DDOVERLAYFX * 15-jul-95 craige set DDCAPS_NOHARDWARE * 15-jul-95 ericeng changed EnumSurface callback param order, BltBatch * params, moved all Const var references to a consistent * location, removed failure mode for height alignment * 18-jul-95 craige removed Flush from surface object * 27-jul-95 craige added DDCAPS_BLTCOLORFILL * 31-jul-95 craige added DDCAPS_BANKSWITCHED, validation flags * 02-aug-95 craige added dwMinOverlayStretch/dwMaxOverlayStretch to DDCAPS * 10-aug-95 toddla added DDBLT_WAIT, DDBLTFAST_WAIT, DDLOCK_WAIT, DDFLIP_WAIT * 13-aug-95 craige added dwCaps2 and reserved fields to DDCAPS; added * DDCAPS2_CERTIFIED; named alpha caps properly; * flags parm for Flip * 13-aug-95 toddla added DDSCL_DONTHOOKHWND * 19-aug-95 ericeng added DDCAPS2_LIVEVIDEO and DDCAPS2_HWCODEC * 21-aug-95 craige mode X support * 27-aug-95 craige bug 742: added DDPCAPS_256 * bug 738: use GUID instead of IID * 22-sep-95 craige bug 1268,1269: getbltstatus/getflipstatus flags wrong * 09-nov-95 colinmc added support for 1, 2 and 4 bit RGB and indexed * palettes * 27-nov-95 colinmc new member to return available vram of a given type * (determined by DDSCAPS). * 05-dec-95 colinmc changed DDSCAPS_TEXTUREMAP => DDSCAPS_TEXTURE for * consistency with Direct3D * 05-dec-95 colinmc added mip-map support * 09-dec-95 colinmc added execute buffer support * 13-dec-95 colinmc added shared back and z-buffer support * 18-dec-95 colinmc added valid caps mask for surface caps * 25-dec-95 craige changed IDirectDrawV2 to IDirectDraw2 * 31-dec-95 craige added CLSID_DirectDraw * 04-jan-96 colinmc added explicit support for z-buffer clears * 12-feb-96 kylej added Interface * 23-feb-96 kylej added IDirectDrawSurface2 Interface * 01-mar-96 kylej new ddcaps structure * 06-mar-96 kylej changed HANDLEs to DWORDs * 13-mar-96 kylej added DD_Surface_GetDDInterface in IDirectDrawSurface2 * 14-mar-96 colinmc added CLSID_DirectDrawClipper and added the clipper * creation API function back in * 21-mar-96 colinmc Bug 13316: Unitialized interfaces * 24-mar-96 colinmc Bug 14321: Structure change to allow flippable mip * map chains with a single call * 26-mar-96 colinmc Bug 14470: Compressed surface support * 15-apr-96 colinmc Bug 16855: Can't pass NULL to Initialize in C++ * 19-apr-96 colinmc Bug 18059: News caps bit to flag that you can't do * 2D during 3D. * 01-may-96 colinmc Bug 20005: InternalLock does not check for lost * surfaces * 28-jun-96 colinmc Bug 2122: Misleading bit depth comments in * DDPIXELFORMAT *@@END_MSINTERNAL * ***************************************************************************/
#ifndef __DDRAW_INCLUDED__
#define __DDRAW_INCLUDED__
#if defined( _WIN32 ) && !defined( _NO_COM )
#define COM_NO_WINDOWS_H
#include <objbase.h>
#else
#define IUnknown void
#define CO_E_NOTINITIALIZED 0x800401F0L
#endif
#define _FACDD 0x876
#define MAKE_DDHRESULT( code ) MAKE_HRESULT( 1, _FACDD, code )
#ifdef __cplusplus
extern "C" {#endif
/*
* GUIDS used by DirectDraw objects */#if defined( _WIN32 ) && !defined( _NO_COM )
DEFINE_GUID( CLSID_DirectDraw, 0xD7B70EE0,0x4340,0x11CF,0xB0,0x63,0x00,0x20,0xAF,0xC2,0xCD,0x35 );DEFINE_GUID( CLSID_DirectDrawClipper, 0x593817A0,0x7DB3,0x11CF,0xA2,0xDE,0x00,0xAA,0x00,0xb9,0x33,0x56 );DEFINE_GUID( IID_IDirectDraw, 0x6C14DB80,0xA733,0x11CE,0xA5,0x21,0x00,0x20,0xAF,0x0B,0xE5,0x60 );DEFINE_GUID( IID_IDirectDraw2, 0xB3A6F3E0,0x2B43,0x11CF,0xA2,0xDE,0x00,0xAA,0x00,0xB9,0x33,0x56 );DEFINE_GUID( IID_IDirectDrawSurface, 0x6C14DB81,0xA733,0x11CE,0xA5,0x21,0x00,0x20,0xAF,0x0B,0xE5,0x60 );DEFINE_GUID( IID_IDirectDrawSurface2, 0x57805885,0x6eec,0x11cf,0x94,0x41,0xa8,0x23,0x03,0xc1,0x0e,0x27 );
//@@BEGIN_MSINTERNAL
#ifdef STREAMING
DEFINE_GUID( IID_IDirectDrawSurfaceStreaming, 0x6C14DB82,0xA733,0x11CE,0xA5,0x21,0x00,0x20,0xAF,0x0B,0xE5,0x60 );#endif
#ifdef COMPOSITION
DEFINE_GUID( IID_IDirectDrawSurfaceComposition, 0x6C14DB83,0xA733,0x11CE,0xA5,0x21,0x00,0x20,0xAF,0x0B,0xE5,0x60 );#endif
//@@END_MSINTERNAL
DEFINE_GUID( IID_IDirectDrawPalette, 0x6C14DB84,0xA733,0x11CE,0xA5,0x21,0x00,0x20,0xAF,0x0B,0xE5,0x60 );DEFINE_GUID( IID_IDirectDrawClipper, 0x6C14DB85,0xA733,0x11CE,0xA5,0x21,0x00,0x20,0xAF,0x0B,0xE5,0x60 ); #endif
/*============================================================================
* * DirectDraw Structures * * Various structures used to invoke DirectDraw. * *==========================================================================*/
struct IDirectDraw;struct IDirectDrawSurface;//@@BEGIN_MSINTERNAL
#ifdef COMPOSITION
struct IDirectDrawSurfaceComposition;#endif
#ifdef STREAMING
struct IDirectDrawSurfaceStreaming;#endif
//@@END_MSINTERNAL
struct IDirectDrawPalette;struct IDirectDrawClipper;
typedef struct IDirectDraw FAR *LPDIRECTDRAW;typedef struct IDirectDraw2 FAR *LPDIRECTDRAW2;typedef struct IDirectDrawSurface FAR *LPDIRECTDRAWSURFACE;typedef struct IDirectDrawSurface2 FAR *LPDIRECTDRAWSURFACE2;
//@@BEGIN_MSINTERNAL
#ifdef COMPOSITION
typedef struct IDirectDrawSurfaceComposition FAR *LPDIRECTDRAWSURFACECOMPOSITION;#endif
#ifdef STREAMING
typedef struct IDirectDrawSurfaceStreaming FAR *LPDIRECTDRAWSURFACESTREAMING;#endif
//@@END_MSINTERNAL
typedef struct IDirectDrawPalette FAR *LPDIRECTDRAWPALETTE;typedef struct IDirectDrawClipper FAR *LPDIRECTDRAWCLIPPER;
typedef struct _DDFXROP FAR *LPDDFXROP;typedef struct _DDSURFACEDESC FAR *LPDDSURFACEDESC;
/*
* API's */#if (defined (WIN32) || defined( _WIN32 ) ) && !defined( _NO_COM )
//#if defined( _WIN32 ) && !defined( _NO_ENUM )
typedef BOOL (FAR PASCAL * LPDDENUMCALLBACKA)(GUID FAR *, LPSTR, LPSTR, LPVOID); typedef BOOL (FAR PASCAL * LPDDENUMCALLBACKW)(GUID FAR *, LPWSTR, LPWSTR, LPVOID); extern HRESULT WINAPI DirectDrawEnumerateW( LPDDENUMCALLBACKW lpCallback, LPVOID lpContext ); extern HRESULT WINAPI DirectDrawEnumerateA( LPDDENUMCALLBACKA lpCallback, LPVOID lpContext ); #ifdef UNICODE
typedef LPDDENUMCALLBACKW LPDDENUMCALLBACK; #define DirectDrawEnumerate DirectDrawEnumerateW
#else
typedef LPDDENUMCALLBACKA LPDDENUMCALLBACK; #define DirectDrawEnumerate DirectDrawEnumerateA
#endif
extern HRESULT WINAPI DirectDrawCreate( GUID FAR *lpGUID, LPDIRECTDRAW FAR *lplpDD, IUnknown FAR *pUnkOuter ); extern HRESULT WINAPI DirectDrawCreateClipper( DWORD dwFlags, LPDIRECTDRAWCLIPPER FAR *lplpDDClipper, IUnknown FAR *pUnkOuter ); #ifdef WINNT
//This is the user-mode entry stub to the kernel mode procedure.
extern HRESULT NtDirectDrawCreate( GUID FAR *lpGUID, HANDLE *lplpDD, IUnknown FAR *pUnkOuter ); #endif
#endif
#define REGSTR_KEY_DDHW_DESCRIPTION "Description"
#define REGSTR_KEY_DDHW_DRIVERNAME "DriverName"
#define REGSTR_PATH_DDHW "Hardware\\DirectDrawDrivers"
#define DDCREATE_HARDWAREONLY 0x00000001l
#define DDCREATE_EMULATIONONLY 0x00000002l
#if defined (WINNT) || !defined(WIN32)
typedef long HRESULT;#endif
//#ifndef WINNT
typedef HRESULT (FAR PASCAL * LPDDENUMMODESCALLBACK)(LPDDSURFACEDESC, LPVOID);typedef HRESULT (FAR PASCAL * LPDDENUMSURFACESCALLBACK)(LPDIRECTDRAWSURFACE, LPDDSURFACEDESC, LPVOID);//#endif
/*
* DDCOLORKEY */typedef struct _DDCOLORKEY{ DWORD dwColorSpaceLowValue; // low boundary of color space that is to
// be treated as Color Key, inclusive
DWORD dwColorSpaceHighValue; // high boundary of color space that is
// to be treated as Color Key, inclusive
} DDCOLORKEY;
typedef DDCOLORKEY FAR* LPDDCOLORKEY;
/*
* DDBLTFX * Used to pass override information to the DIRECTDRAWSURFACE callback Blt. */typedef struct _DDBLTFX{ DWORD dwSize; // size of structure
DWORD dwDDFX; // FX operations
DWORD dwROP; // Win32 raster operations
DWORD dwDDROP; // Raster operations new for DirectDraw
DWORD dwRotationAngle; // Rotation angle for blt
DWORD dwZBufferOpCode; // ZBuffer compares
DWORD dwZBufferLow; // Low limit of Z buffer
DWORD dwZBufferHigh; // High limit of Z buffer
DWORD dwZBufferBaseDest; // Destination base value
DWORD dwZDestConstBitDepth; // Bit depth used to specify Z constant for destination
union { DWORD dwZDestConst; // Constant to use as Z buffer for dest
LPDIRECTDRAWSURFACE lpDDSZBufferDest; // Surface to use as Z buffer for dest
}; DWORD dwZSrcConstBitDepth; // Bit depth used to specify Z constant for source
union { DWORD dwZSrcConst; // Constant to use as Z buffer for src
LPDIRECTDRAWSURFACE lpDDSZBufferSrc; // Surface to use as Z buffer for src
}; DWORD dwAlphaEdgeBlendBitDepth; // Bit depth used to specify constant for alpha edge blend
DWORD dwAlphaEdgeBlend; // Alpha for edge blending
DWORD dwReserved; DWORD dwAlphaDestConstBitDepth; // Bit depth used to specify alpha constant for destination
union { DWORD dwAlphaDestConst; // Constant to use as Alpha Channel
LPDIRECTDRAWSURFACE lpDDSAlphaDest; // Surface to use as Alpha Channel
}; DWORD dwAlphaSrcConstBitDepth; // Bit depth used to specify alpha constant for source
union { DWORD dwAlphaSrcConst; // Constant to use as Alpha Channel
LPDIRECTDRAWSURFACE lpDDSAlphaSrc; // Surface to use as Alpha Channel
}; union { DWORD dwFillColor; // color in RGB or Palettized
DWORD dwFillDepth; // depth value for z-buffer
LPDIRECTDRAWSURFACE lpDDSPattern; // Surface to use as pattern
}; DDCOLORKEY ddckDestColorkey; // DestColorkey override
DDCOLORKEY ddckSrcColorkey; // SrcColorkey override
} DDBLTFX;
typedef DDBLTFX FAR* LPDDBLTFX;
//@@BEGIN_MSINTERNAL
#ifdef COMPOSITION
/*
* DDCOMPOSEFX * Used to pass override information to the DIRECTDRAWSURFACE callback Compose. */typedef DWORD (FAR PASCAL *LPCOMPOSECALLBACK)(DWORD);typedef struct _DDCOMPOSEFX{ DWORD dwSize; // size of structure
DWORD dwDDFX; // FX operations
DWORD dwROP; // Win32 raster operations
DWORD dwDDROP; // Raster operations new for DirectDraw
DWORD dwRotationAngle; // Rotation angle for blt
DWORD dwZBufferOpCode; // ZBuffer compares
DWORD dwZBufferLow; // Low limit of Z buffer
DWORD dwZBufferHigh; // High limit of Z buffer
DWORD dwZBufferBaseDest; // Destination base value
DWORD dwZDestConstBitDepth; // Bit depth used to specify Z constant for destination
union { DWORD dwZDestConst; // Constant to use as Z buffer for dest
LPDIRECTDRAWSURFACE lpDDSZBufferDest; // Surface to use as Z buffer for dest
}; DWORD dwZSrcConstBitDepth; // Bit depth used to specify Z constant for source
union { DWORD dwZSrcConst; // Constant to use as Z buffer for src
LPDIRECTDRAWSURFACE lpDDSZBufferSrc; // Surface to use as Z buffer for src
}; DWORD dwAlphaEdgeBlendBitDepth; // Bit depth used to specify constant for alpha edge blend
DWORD dwAlphaEdgeBlend; // Alpha for edge blending
DWORD dwReserved; DWORD dwAlphaDestConstBitDepth; // Bit depth used to specify alpha constant for destination
union { DWORD dwAlphaDestConst; // Constant to use as Alpha Channel
LPDIRECTDRAWSURFACE lpDDSAlphaDest; // Surface to use as Alpha Channel
}; DWORD dwAlphaSrcConstBitDepth; // Bit depth used to specify alpha constant for source
union { DWORD dwAlphaSrcConst; // Constant to use as Alpha Channel
LPDIRECTDRAWSURFACE lpDDSAlphaSrc; // Surface to use as Alpha Channel
}; union { DWORD dwFillColor; // color in RGB or Palettized
LPDIRECTDRAWSURFACE lpDDSPattern; // Surface to use as pattern
}; DDCOLORKEY ddckDestColorkey; // DestColorkey override
DDCOLORKEY ddckSrcColorkey; // SrcColorkey override
DWORD dwRepeat; // how many times to repeat the composition command
LPCOMPOSECALLBACK lpfnCallback; // function to call prior to execution of each compose command
} DDCOMPOSEFX;
typedef DDCOMPOSEFX FAR* LPDDCOMPOSEFX;#endif
//@@END_MSINTERNAL
/*
* DDSCAPS */typedef struct _DDSCAPS{ DWORD dwCaps; // capabilities of surface wanted
} DDSCAPS;
typedef DDSCAPS FAR* LPDDSCAPS;
/*
* DDCAPS */#define DD_ROP_SPACE (256/32) // space required to store ROP array
//@@BEGIN_MSINTERNAL
/*
* This structure represents the DDCAPS structure released in DirectDraw 1.0. It is used internally * by DirectDraw to interpret caps passed into ddraw by drivers written prior to the release of DirectDraw 2.0. * New applications should use the DDCAPS structure defined below. */typedef struct _DDCAPS_V1{ DWORD dwSize; // size of the DDDRIVERCAPS structure
DWORD dwCaps; // driver specific capabilities
DWORD dwCaps2; // more driver specific capabilites
DWORD dwCKeyCaps; // color key capabilities of the surface
DWORD dwFXCaps; // driver specific stretching and effects capabilites
DWORD dwFXAlphaCaps; // alpha driver specific capabilities
DWORD dwPalCaps; // palette capabilities
DWORD dwSVCaps; // stereo vision capabilities
DWORD dwAlphaBltConstBitDepths; // DDBD_2,4,8
DWORD dwAlphaBltPixelBitDepths; // DDBD_1,2,4,8
DWORD dwAlphaBltSurfaceBitDepths; // DDBD_1,2,4,8
DWORD dwAlphaOverlayConstBitDepths; // DDBD_2,4,8
DWORD dwAlphaOverlayPixelBitDepths; // DDBD_1,2,4,8
DWORD dwAlphaOverlaySurfaceBitDepths; // DDBD_1,2,4,8
DWORD dwZBufferBitDepths; // DDBD_8,16,24,32
DWORD dwVidMemTotal; // total amount of video memory
DWORD dwVidMemFree; // amount of free video memory
DWORD dwMaxVisibleOverlays; // maximum number of visible overlays
DWORD dwCurrVisibleOverlays; // current number of visible overlays
DWORD dwNumFourCCCodes; // number of four cc codes
DWORD dwAlignBoundarySrc; // source rectangle alignment
DWORD dwAlignSizeSrc; // source rectangle byte size
DWORD dwAlignBoundaryDest; // dest rectangle alignment
DWORD dwAlignSizeDest; // dest rectangle byte size
DWORD dwAlignStrideAlign; // stride alignment
DWORD dwRops[DD_ROP_SPACE]; // ROPS supported
DDSCAPS ddsCaps; // DDSCAPS structure has all the general capabilities
DWORD dwMinOverlayStretch; // minimum overlay stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
DWORD dwMaxOverlayStretch; // maximum overlay stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
DWORD dwMinLiveVideoStretch; // minimum live video stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
DWORD dwMaxLiveVideoStretch; // maximum live video stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
DWORD dwMinHwCodecStretch; // minimum hardware codec stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
DWORD dwMaxHwCodecStretch; // maximum hardware codec stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
DWORD dwReserved1; // reserved
DWORD dwReserved2; // reserved
DWORD dwReserved3; // reserved
} DDCAPS_V1;
typedef DDCAPS_V1 FAR* LPDDCAPS_V1;//@@END_MSINTERNAL
typedef struct _DDCAPS{ DWORD dwSize; // size of the DDDRIVERCAPS structure
DWORD dwCaps; // driver specific capabilities
DWORD dwCaps2; // more driver specific capabilites
DWORD dwCKeyCaps; // color key capabilities of the surface
DWORD dwFXCaps; // driver specific stretching and effects capabilites
DWORD dwFXAlphaCaps; // alpha driver specific capabilities
DWORD dwPalCaps; // palette capabilities
DWORD dwSVCaps; // stereo vision capabilities
DWORD dwAlphaBltConstBitDepths; // DDBD_2,4,8
DWORD dwAlphaBltPixelBitDepths; // DDBD_1,2,4,8
DWORD dwAlphaBltSurfaceBitDepths; // DDBD_1,2,4,8
DWORD dwAlphaOverlayConstBitDepths; // DDBD_2,4,8
DWORD dwAlphaOverlayPixelBitDepths; // DDBD_1,2,4,8
DWORD dwAlphaOverlaySurfaceBitDepths; // DDBD_1,2,4,8
DWORD dwZBufferBitDepths; // DDBD_8,16,24,32
DWORD dwVidMemTotal; // total amount of video memory
DWORD dwVidMemFree; // amount of free video memory
DWORD dwMaxVisibleOverlays; // maximum number of visible overlays
DWORD dwCurrVisibleOverlays; // current number of visible overlays
DWORD dwNumFourCCCodes; // number of four cc codes
DWORD dwAlignBoundarySrc; // source rectangle alignment
DWORD dwAlignSizeSrc; // source rectangle byte size
DWORD dwAlignBoundaryDest; // dest rectangle alignment
DWORD dwAlignSizeDest; // dest rectangle byte size
DWORD dwAlignStrideAlign; // stride alignment
DWORD dwRops[DD_ROP_SPACE]; // ROPS supported
DDSCAPS ddsCaps; // DDSCAPS structure has all the general capabilities
DWORD dwMinOverlayStretch; // minimum overlay stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
DWORD dwMaxOverlayStretch; // maximum overlay stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
DWORD dwMinLiveVideoStretch; // minimum live video stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
DWORD dwMaxLiveVideoStretch; // maximum live video stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
DWORD dwMinHwCodecStretch; // minimum hardware codec stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
DWORD dwMaxHwCodecStretch; // maximum hardware codec stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
DWORD dwReserved1; // reserved
DWORD dwReserved2; // reserved
DWORD dwReserved3; // reserved
DWORD dwSVBCaps; // driver specific capabilities for System->Vmem blts
DWORD dwSVBCKeyCaps; // driver color key capabilities for System->Vmem blts
DWORD dwSVBFXCaps; // driver FX capabilities for System->Vmem blts
DWORD dwSVBRops[DD_ROP_SPACE];// ROPS supported for System->Vmem blts
DWORD dwVSBCaps; // driver specific capabilities for Vmem->System blts
DWORD dwVSBCKeyCaps; // driver color key capabilities for Vmem->System blts
DWORD dwVSBFXCaps; // driver FX capabilities for Vmem->System blts
DWORD dwVSBRops[DD_ROP_SPACE];// ROPS supported for Vmem->System blts
DWORD dwSSBCaps; // driver specific capabilities for System->System blts
DWORD dwSSBCKeyCaps; // driver color key capabilities for System->System blts
DWORD dwSSBFXCaps; // driver FX capabilities for System->System blts
DWORD dwSSBRops[DD_ROP_SPACE];// ROPS supported for System->System blts
DWORD dwReserved4; // reserved
DWORD dwReserved5; // reserved
DWORD dwReserved6; // reserved
} DDCAPS;
typedef DDCAPS FAR* LPDDCAPS;
/*
* DDPIXELFORMAT */typedef struct _DDPIXELFORMAT{ DWORD dwSize; // size of structure
DWORD dwFlags; // pixel format flags
DWORD dwFourCC; // (FOURCC code)
union { DWORD dwRGBBitCount; // how many bits per pixel
DWORD dwYUVBitCount; // how many bits per pixel
DWORD dwZBufferBitDepth; // how many bits for z buffers
DWORD dwAlphaBitDepth; // how many bits for alpha channels
}; union { DWORD dwRBitMask; // mask for red bit
DWORD dwYBitMask; // mask for Y bits
}; union { DWORD dwGBitMask; // mask for green bits
DWORD dwUBitMask; // mask for U bits
}; union { DWORD dwBBitMask; // mask for blue bits
DWORD dwVBitMask; // mask for V bits
}; union { DWORD dwRGBAlphaBitMask; // mask for alpha channel
DWORD dwYUVAlphaBitMask; // mask for alpha channel
};} DDPIXELFORMAT;
typedef DDPIXELFORMAT FAR* LPDDPIXELFORMAT;
/*
* DDOVERLAYFX */typedef struct _DDOVERLAYFX{ DWORD dwSize; // size of structure
DWORD dwAlphaEdgeBlendBitDepth; // Bit depth used to specify constant for alpha edge blend
DWORD dwAlphaEdgeBlend; // Constant to use as alpha for edge blend
DWORD dwReserved; DWORD dwAlphaDestConstBitDepth; // Bit depth used to specify alpha constant for destination
union { DWORD dwAlphaDestConst; // Constant to use as alpha channel for dest
LPDIRECTDRAWSURFACE lpDDSAlphaDest; // Surface to use as alpha channel for dest
}; DWORD dwAlphaSrcConstBitDepth; // Bit depth used to specify alpha constant for source
union { DWORD dwAlphaSrcConst; // Constant to use as alpha channel for src
LPDIRECTDRAWSURFACE lpDDSAlphaSrc; // Surface to use as alpha channel for src
}; DDCOLORKEY dckDestColorkey; // DestColorkey override
DDCOLORKEY dckSrcColorkey; // DestColorkey override
DWORD dwDDFX; // Overlay FX
DWORD dwFlags; // flags
} DDOVERLAYFX;
typedef DDOVERLAYFX FAR *LPDDOVERLAYFX;
/*
* DDBLTBATCH: BltBatch entry structure */typedef struct _DDBLTBATCH{ LPRECT lprDest; LPDIRECTDRAWSURFACE lpDDSSrc; LPRECT lprSrc; DWORD dwFlags; LPDDBLTFX lpDDBltFx;} DDBLTBATCH;
typedef DDBLTBATCH FAR * LPDDBLTBATCH;
/*
* callbacks */typedef DWORD (FAR PASCAL *LPCLIPPERCALLBACK)(LPDIRECTDRAWCLIPPER lpDDClipper, HWND hWnd, DWORD code, LPVOID lpContext );#ifdef STREAMING
typedef DWORD (FAR PASCAL *LPSURFACESTREAMINGCALLBACK)(DWORD);#endif
//@@BEGIN_MSINTERNAL
#ifdef CLIPPER_NOTIFY
/*
* values passed into the clipper callback */#ifndef WINWATCHNOTIFY_START
#define WINWATCHNOTIFY_START 0
#define WINWATCHNOTIFY_STOP 1
#define WINWATCHNOTIFY_DESTROY 2
#define WINWATCHNOTIFY_CHANGING 3
#define WINWATCHNOTIFY_CHANGED 4
#endif
#endif
//@@END_MSINTERNAL
/*
* INTERACES FOLLOW: * IDirectDraw * IDirectDrawClipper * IDirectDrawPalette * IDirectDrawSurface *@@BEGIN_MSINTERNAL * IDirectDrawSurfaceStreaming * IDirectDrawSurfaceComposition * IDirectDrawSurfaceClipperEx * // this would allow multiple clipper objects to be attached
* // to the same destination
*@@END_MSINTERNAL */
/*
* IDirectDraw */#if defined( _WIN32 ) && !defined( _NO_COM )
#undef INTERFACE
#define INTERFACE IDirectDraw
DECLARE_INTERFACE_( IDirectDraw, IUnknown ){ /*** IUnknown methods ***/ STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE; STDMETHOD_(ULONG,AddRef) (THIS) PURE; STDMETHOD_(ULONG,Release) (THIS) PURE; /*** IDirectDraw methods ***/ STDMETHOD(Compact)(THIS) PURE; STDMETHOD(CreateClipper)(THIS_ DWORD, LPDIRECTDRAWCLIPPER FAR*, IUnknown FAR * ) PURE; STDMETHOD(CreatePalette)(THIS_ DWORD, LPPALETTEENTRY, LPDIRECTDRAWPALETTE FAR*, IUnknown FAR * ) PURE; STDMETHOD(CreateSurface)(THIS_ LPDDSURFACEDESC, LPDIRECTDRAWSURFACE FAR *, IUnknown FAR *) PURE; STDMETHOD(DuplicateSurface)( THIS_ LPDIRECTDRAWSURFACE, LPDIRECTDRAWSURFACE FAR * ) PURE; STDMETHOD(EnumDisplayModes)( THIS_ DWORD, LPDDSURFACEDESC, LPVOID, LPDDENUMMODESCALLBACK ) PURE; STDMETHOD(EnumSurfaces)(THIS_ DWORD, LPDDSURFACEDESC, LPVOID,LPDDENUMSURFACESCALLBACK ) PURE; STDMETHOD(FlipToGDISurface)(THIS) PURE; STDMETHOD(GetCaps)( THIS_ LPDDCAPS, LPDDCAPS) PURE; STDMETHOD(GetDisplayMode)( THIS_ LPDDSURFACEDESC) PURE; STDMETHOD(GetFourCCCodes)(THIS_ LPDWORD, LPDWORD ) PURE; STDMETHOD(GetGDISurface)(THIS_ LPDIRECTDRAWSURFACE FAR *) PURE; STDMETHOD(GetMonitorFrequency)(THIS_ LPDWORD) PURE; STDMETHOD(GetScanLine)(THIS_ LPDWORD) PURE; STDMETHOD(GetVerticalBlankStatus)(THIS_ LPBOOL ) PURE; STDMETHOD(Initialize)(THIS_ GUID FAR *) PURE; STDMETHOD(RestoreDisplayMode)(THIS) PURE; STDMETHOD(SetCooperativeLevel)(THIS_ HWND, DWORD) PURE; STDMETHOD(SetDisplayMode)(THIS_ DWORD, DWORD,DWORD) PURE; STDMETHOD(WaitForVerticalBlank)(THIS_ DWORD, HANDLE ) PURE;};
#if !defined(__cplusplus) || defined(CINTERFACE)
#define IDirectDraw_QueryInterface(p, a, b) (p)->lpVtbl->QueryInterface(p, a, b)
#define IDirectDraw_AddRef(p) (p)->lpVtbl->AddRef(p)
#define IDirectDraw_Release(p) (p)->lpVtbl->Release(p)
#define IDirectDraw_Compact(p) (p)->lpVtbl->Compact(p)
#define IDirectDraw_CreateClipper(p, a, b, c) (p)->lpVtbl->CreateClipper(p, a, b, c)
#define IDirectDraw_CreatePalette(p, a, b, c, d) (p)->lpVtbl->CreatePalette(p, a, b, c, d)
#define IDirectDraw_CreateSurface(p, a, b, c) (p)->lpVtbl->CreateSurface(p, a, b, c)
#define IDirectDraw_DuplicateSurface(p, a, b) (p)->lpVtbl->DuplicateSurface(p, a, b)
#define IDirectDraw_EnumDisplayModes(p, a, b, c, d) (p)->lpVtbl->EnumDisplayModes(p, a, b, c, d)
#define IDirectDraw_EnumSurfaces(p, a, b, c, d) (p)->lpVtbl->EnumSurfaces(p, a, b, c, d)
#define IDirectDraw_FlipToGDISurface(p) (p)->lpVtbl->FlipToGDISurface(p)
#define IDirectDraw_GetCaps(p, a, b) (p)->lpVtbl->GetCaps(p, a, b)
#define IDirectDraw_GetDisplayMode(p, a) (p)->lpVtbl->GetDisplayMode(p, a)
#define IDirectDraw_GetFourCCCodes(p, a, b) (p)->lpVtbl->GetFourCCCodes(p, a, b)
#define IDirectDraw_GetGDISurface(p, a) (p)->lpVtbl->GetGDISurface(p, a)
#define IDirectDraw_GetMonitorFrequency(p, a) (p)->lpVtbl->GetMonitorFrequency(p, a)
#define IDirectDraw_GetScanLine(p, a) (p)->lpVtbl->GetScanLine(p, a)
#define IDirectDraw_GetVerticalBlankStatus(p, a) (p)->lpVtbl->GetVerticalBlankStatus(p, a)
#define IDirectDraw_Initialize(p, a) (p)->lpVtbl->Initialize(p, a)
#define IDirectDraw_RestoreDisplayMode(p) (p)->lpVtbl->RestoreDisplayMode(p)
#define IDirectDraw_SetCooperativeLevel(p, a, b) (p)->lpVtbl->SetCooperativeLevel(p, a, b)
#define IDirectDraw_SetDisplayMode(p, a, b, c) (p)->lpVtbl->SetDisplayMode(p, a, b, c)
#define IDirectDraw_WaitForVerticalBlank(p, a, b) (p)->lpVtbl->WaitForVerticalBlank(p, a, b)
#endif
#endif
#if defined( _WIN32 ) && !defined( _NO_COM )
#undef INTERFACE
#define INTERFACE IDirectDraw2
DECLARE_INTERFACE_( IDirectDraw2, IUnknown ){ /*** IUnknown methods ***/ STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE; STDMETHOD_(ULONG,AddRef) (THIS) PURE; STDMETHOD_(ULONG,Release) (THIS) PURE; /*** IDirectDraw methods ***/ STDMETHOD(Compact)(THIS) PURE; STDMETHOD(CreateClipper)(THIS_ DWORD, LPDIRECTDRAWCLIPPER FAR*, IUnknown FAR * ) PURE; STDMETHOD(CreatePalette)(THIS_ DWORD, LPPALETTEENTRY, LPDIRECTDRAWPALETTE FAR*, IUnknown FAR * ) PURE; STDMETHOD(CreateSurface)(THIS_ LPDDSURFACEDESC, LPDIRECTDRAWSURFACE FAR *, IUnknown FAR *) PURE; STDMETHOD(DuplicateSurface)( THIS_ LPDIRECTDRAWSURFACE, LPDIRECTDRAWSURFACE FAR * ) PURE; STDMETHOD(EnumDisplayModes)( THIS_ DWORD, LPDDSURFACEDESC, LPVOID, LPDDENUMMODESCALLBACK ) PURE; STDMETHOD(EnumSurfaces)(THIS_ DWORD, LPDDSURFACEDESC, LPVOID,LPDDENUMSURFACESCALLBACK ) PURE; STDMETHOD(FlipToGDISurface)(THIS) PURE; STDMETHOD(GetCaps)( THIS_ LPDDCAPS, LPDDCAPS) PURE; STDMETHOD(GetDisplayMode)( THIS_ LPDDSURFACEDESC) PURE; STDMETHOD(GetFourCCCodes)(THIS_ LPDWORD, LPDWORD ) PURE; STDMETHOD(GetGDISurface)(THIS_ LPDIRECTDRAWSURFACE FAR *) PURE; STDMETHOD(GetMonitorFrequency)(THIS_ LPDWORD) PURE; STDMETHOD(GetScanLine)(THIS_ LPDWORD) PURE; STDMETHOD(GetVerticalBlankStatus)(THIS_ LPBOOL ) PURE; STDMETHOD(Initialize)(THIS_ GUID FAR *) PURE; STDMETHOD(RestoreDisplayMode)(THIS) PURE; STDMETHOD(SetCooperativeLevel)(THIS_ HWND, DWORD) PURE; STDMETHOD(SetDisplayMode)(THIS_ DWORD, DWORD,DWORD, DWORD, DWORD) PURE; STDMETHOD(WaitForVerticalBlank)(THIS_ DWORD, HANDLE ) PURE; /*** Added in the v2 interface ***/ STDMETHOD(GetAvailableVidMem)(THIS_ LPDDSCAPS, LPDWORD, LPDWORD) PURE;};#if !defined(__cplusplus) || defined(CINTERFACE)
#define IDirectDraw2_QueryInterface(p, a, b) (p)->lpVtbl->QueryInterface(p, a, b)
#define IDirectDraw2_AddRef(p) (p)->lpVtbl->AddRef(p)
#define IDirectDraw2_Release(p) (p)->lpVtbl->Release(p)
#define IDirectDraw2_Compact(p) (p)->lpVtbl->Compact(p)
#define IDirectDraw2_CreateClipper(p, a, b, c) (p)->lpVtbl->CreateClipper(p, a, b, c)
#define IDirectDraw2_CreatePalette(p, a, b, c, d) (p)->lpVtbl->CreatePalette(p, a, b, c, d)
#define IDirectDraw2_CreateSurface(p, a, b, c) (p)->lpVtbl->CreateSurface(p, a, b, c)
#define IDirectDraw2_DuplicateSurface(p, a, b) (p)->lpVtbl->DuplicateSurface(p, a, b)
#define IDirectDraw2_EnumDisplayModes(p, a, b, c, d) (p)->lpVtbl->EnumDisplayModes(p, a, b, c, d)
#define IDirectDraw2_EnumSurfaces(p, a, b, c, d) (p)->lpVtbl->EnumSurfaces(p, a, b, c, d)
#define IDirectDraw2_FlipToGDISurface(p) (p)->lpVtbl->FlipToGDISurface(p)
#define IDirectDraw2_GetCaps(p, a, b) (p)->lpVtbl->GetCaps(p, a, b)
#define IDirectDraw2_GetDisplayMode(p, a) (p)->lpVtbl->GetDisplayMode(p, a)
#define IDirectDraw2_GetFourCCCodes(p, a, b) (p)->lpVtbl->GetFourCCCodes(p, a, b)
#define IDirectDraw2_GetGDISurface(p, a) (p)->lpVtbl->GetGDISurface(p, a)
#define IDirectDraw2_GetMonitorFrequency(p, a) (p)->lpVtbl->GetMonitorFrequency(p, a)
#define IDirectDraw2_GetScanLine(p, a) (p)->lpVtbl->GetScanLine(p, a)
#define IDirectDraw2_GetVerticalBlankStatus(p, a) (p)->lpVtbl->GetVerticalBlankStatus(p, a)
#define IDirectDraw2_Initialize(p, a) (p)->lpVtbl->Initialize(p, a)
#define IDirectDraw2_RestoreDisplayMode(p) (p)->lpVtbl->RestoreDisplayMode(p)
#define IDirectDraw2_SetCooperativeLevel(p, a, b) (p)->lpVtbl->SetCooperativeLevel(p, a, b)
#define IDirectDraw2_SetDisplayMode(p, a, b, c, d, e) (p)->lpVtbl->SetDisplayMode(p, a, b, c, d, e)
#define IDirectDraw2_WaitForVerticalBlank(p, a, b) (p)->lpVtbl->WaitForVerticalBlank(p, a, b)
#define IDirectDraw2_GetAvailableVidMem(p, a, b, c) (p)->lpVtbl->GetAvailableVidMem(p, a, b, c)
#endif
#endif
/*
* IDirectDrawPalette */#if defined( _WIN32 ) && !defined( _NO_COM )
#undef INTERFACE
#define INTERFACE IDirectDrawPalette
DECLARE_INTERFACE_( IDirectDrawPalette, IUnknown ){ /*** IUnknown methods ***/ STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE; STDMETHOD_(ULONG,AddRef) (THIS) PURE; STDMETHOD_(ULONG,Release) (THIS) PURE; /*** IDirectDrawPalette methods ***/ STDMETHOD(GetCaps)(THIS_ LPDWORD) PURE; STDMETHOD(GetEntries)(THIS_ DWORD,DWORD,DWORD,LPPALETTEENTRY) PURE; STDMETHOD(Initialize)(THIS_ LPDIRECTDRAW, DWORD, LPPALETTEENTRY) PURE; STDMETHOD(SetEntries)(THIS_ DWORD,DWORD,DWORD,LPPALETTEENTRY) PURE;};
#if !defined(__cplusplus) || defined(CINTERFACE)
#define IDirectDrawPalette_QueryInterface(p, a, b) (p)->lpVtbl->QueryInterface(p, a, b)
#define IDirectDrawPalette_AddRef(p) (p)->lpVtbl->AddRef(p)
#define IDirectDrawPalette_Release(p) (p)->lpVtbl->Release(p)
#define IDirectDrawPalette_GetCaps(p, a) (p)->lpVtbl->GetCaps(p, a)
#define IDirectDrawPalette_GetEntries(p, a, b, c, d) (p)->lpVtbl->GetEntries(p, a, b, c, d)
#define IDirectDrawPalette_Initialize(p, a, b, c) (p)->lpVtbl->Initialize(p, a, b, c)
#define IDirectDrawPalette_SetEntries(p, a, b, c, d) (p)->lpVtbl->SetEntries(p, a, b, c, d)
#endif
#endif
/*
* IDirectDrawClipper */#if defined( _WIN32 ) && !defined( _NO_COM )
#undef INTERFACE
#define INTERFACE IDirectDrawClipper
DECLARE_INTERFACE_( IDirectDrawClipper, IUnknown ){ /*** IUnknown methods ***/ STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE; STDMETHOD_(ULONG,AddRef) (THIS) PURE; STDMETHOD_(ULONG,Release) (THIS) PURE; /*** IDirectDrawClipper methods ***/ STDMETHOD(GetClipList)(THIS_ LPRECT, LPRGNDATA, LPDWORD) PURE; STDMETHOD(GetHWnd)(THIS_ HWND FAR *) PURE; STDMETHOD(Initialize)(THIS_ LPDIRECTDRAW, DWORD) PURE; STDMETHOD(IsClipListChanged)(THIS_ BOOL FAR *) PURE; STDMETHOD(SetClipList)(THIS_ LPRGNDATA,DWORD) PURE; STDMETHOD(SetHWnd)(THIS_ DWORD, HWND ) PURE;};
#if !defined(__cplusplus) || defined(CINTERFACE)
#define IDirectDrawClipper_QueryInterface(p, a, b) (p)->lpVtbl->QueryInterface(p, a, b)
#define IDirectDrawClipper_AddRef(p) (p)->lpVtbl->AddRef(p)
#define IDirectDrawClipper_Release(p) (p)->lpVtbl->Release(p)
#define IDirectDrawClipper_GetClipList(p, a, b, c) (p)->lpVtbl->GetClipList(p, a, b, c)
#define IDirectDrawClipper_GetHWnd(p, a) (p)->lpVtbl->GetHWnd(p, a)
#define IDirectDrawClipper_Initialize(p, a, b) (p)->lpVtbl->Initialize(p, a, b)
#define IDirectDrawClipper_IsClipListChanged(p, a) (p)->lpVtbl->IsClipListChanged(p, a)
#define IDirectDrawClipper_SetClipList(p, a, b) (p)->lpVtbl->SetClipList(p, a, b)
#define IDirectDrawClipper_SetHWnd(p, a, b) (p)->lpVtbl->SetHWnd(p, a, b)
#endif
#endif
/*
* IDirectDrawSurface and related interfaces */#if defined( _WIN32 ) && !defined( _NO_COM )
#undef INTERFACE
#define INTERFACE IDirectDrawSurface
DECLARE_INTERFACE_( IDirectDrawSurface, IUnknown ){ /*** IUnknown methods ***/ STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE; STDMETHOD_(ULONG,AddRef) (THIS) PURE; STDMETHOD_(ULONG,Release) (THIS) PURE; /*** IDirectDrawSurface methods ***/ STDMETHOD(AddAttachedSurface)(THIS_ LPDIRECTDRAWSURFACE) PURE; STDMETHOD(AddOverlayDirtyRect)(THIS_ LPRECT) PURE; STDMETHOD(Blt)(THIS_ LPRECT,LPDIRECTDRAWSURFACE, LPRECT,DWORD, LPDDBLTFX) PURE; STDMETHOD(BltBatch)(THIS_ LPDDBLTBATCH, DWORD, DWORD ) PURE; STDMETHOD(BltFast)(THIS_ DWORD,DWORD,LPDIRECTDRAWSURFACE, LPRECT,DWORD) PURE; STDMETHOD(DeleteAttachedSurface)(THIS_ DWORD,LPDIRECTDRAWSURFACE) PURE; STDMETHOD(EnumAttachedSurfaces)(THIS_ LPVOID,LPDDENUMSURFACESCALLBACK) PURE; STDMETHOD(EnumOverlayZOrders)(THIS_ DWORD,LPVOID,LPDDENUMSURFACESCALLBACK) PURE; STDMETHOD(Flip)(THIS_ LPDIRECTDRAWSURFACE, DWORD) PURE; STDMETHOD(GetAttachedSurface)(THIS_ LPDDSCAPS, LPDIRECTDRAWSURFACE FAR *) PURE; STDMETHOD(GetBltStatus)(THIS_ DWORD) PURE; STDMETHOD(GetCaps)(THIS_ LPDDSCAPS) PURE; STDMETHOD(GetClipper)(THIS_ LPDIRECTDRAWCLIPPER FAR*) PURE; STDMETHOD(GetColorKey)(THIS_ DWORD, LPDDCOLORKEY) PURE; STDMETHOD(GetDC)(THIS_ HDC FAR *) PURE; STDMETHOD(GetFlipStatus)(THIS_ DWORD) PURE; STDMETHOD(GetOverlayPosition)(THIS_ LPLONG, LPLONG ) PURE; STDMETHOD(GetPalette)(THIS_ LPDIRECTDRAWPALETTE FAR*) PURE; STDMETHOD(GetPixelFormat)(THIS_ LPDDPIXELFORMAT) PURE; STDMETHOD(GetSurfaceDesc)(THIS_ LPDDSURFACEDESC) PURE; STDMETHOD(Initialize)(THIS_ LPDIRECTDRAW, LPDDSURFACEDESC) PURE; STDMETHOD(IsLost)(THIS) PURE; STDMETHOD(Lock)(THIS_ LPRECT,LPDDSURFACEDESC,DWORD,HANDLE) PURE; STDMETHOD(ReleaseDC)(THIS_ HDC) PURE; STDMETHOD(Restore)(THIS) PURE; STDMETHOD(SetClipper)(THIS_ LPDIRECTDRAWCLIPPER) PURE; STDMETHOD(SetColorKey)(THIS_ DWORD, LPDDCOLORKEY) PURE; STDMETHOD(SetOverlayPosition)(THIS_ LONG, LONG ) PURE; STDMETHOD(SetPalette)(THIS_ LPDIRECTDRAWPALETTE) PURE; STDMETHOD(Unlock)(THIS_ LPVOID) PURE; STDMETHOD(UpdateOverlay)(THIS_ LPRECT, LPDIRECTDRAWSURFACE,LPRECT,DWORD, LPDDOVERLAYFX) PURE; STDMETHOD(UpdateOverlayDisplay)(THIS_ DWORD) PURE; STDMETHOD(UpdateOverlayZOrder)(THIS_ DWORD, LPDIRECTDRAWSURFACE) PURE;};
#if !defined(__cplusplus) || defined(CINTERFACE)
#define IDirectDrawSurface_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
#define IDirectDrawSurface_AddRef(p) (p)->lpVtbl->AddRef(p)
#define IDirectDrawSurface_Release(p) (p)->lpVtbl->Release(p)
#define IDirectDrawSurface_AddAttachedSurface(p,a) (p)->lpVtbl->AddAttachedSurface(p,a)
#define IDirectDrawSurface_AddOverlayDirtyRect(p,a) (p)->lpVtbl->AddOverlayDirtyRect(p,a)
#define IDirectDrawSurface_Blt(p,a,b,c,d,e) (p)->lpVtbl->Blt(p,a,b,c,d,e)
#define IDirectDrawSurface_BltBatch(p,a,b,c) (p)->lpVtbl->BltBatch(p,a,b,c)
#define IDirectDrawSurface_BltFast(p,a,b,c,d,e) (p)->lpVtbl->BltFast(p,a,b,c,d,e)
#define IDirectDrawSurface_DeleteAttachedSurface(p,a,b) (p)->lpVtbl->DeleteAttachedSurface(p,a,b)
#define IDirectDrawSurface_EnumAttachedSurfaces(p,a,b) (p)->lpVtbl->EnumAttachedSurfaces(p,a,b)
#define IDirectDrawSurface_EnumOverlayZOrders(p,a,b,c) (p)->lpVtbl->EnumOverlayZOrders(p,a,b,c)
#define IDirectDrawSurface_Flip(p,a,b) (p)->lpVtbl->Flip(p,a,b)
#define IDirectDrawSurface_GetAttachedSurface(p,a,b) (p)->lpVtbl->GetAttachedSurface(p,a,b)
#define IDirectDrawSurface_GetBltStatus(p,a) (p)->lpVtbl->GetBltStatus(p,a)
#define IDirectDrawSurface_GetCaps(p,b) (p)->lpVtbl->GetCaps(p,b)
#define IDirectDrawSurface_GetClipper(p,a) (p)->lpVtbl->GetClipper(p,a)
#define IDirectDrawSurface_GetColorKey(p,a,b) (p)->lpVtbl->GetColorKey(p,a,b)
#define IDirectDrawSurface_GetDC(p,a) (p)->lpVtbl->GetDC(p,a)
#define IDirectDrawSurface_GetFlipStatus(p,a) (p)->lpVtbl->GetFlipStatus(p,a)
#define IDirectDrawSurface_GetOverlayPosition(p,a,b) (p)->lpVtbl->GetOverlayPosition(p,a,b)
#define IDirectDrawSurface_GetPalette(p,a) (p)->lpVtbl->GetPalette(p,a)
#define IDirectDrawSurface_GetPixelFormat(p,a) (p)->lpVtbl->GetPixelFormat(p,a)
#define IDirectDrawSurface_GetSurfaceDesc(p,a) (p)->lpVtbl->GetSurfaceDesc(p,a)
#define IDirectDrawSurface_Initialize(p,a,b) (p)->lpVtbl->Initialize(p,a,b)
#define IDirectDrawSurface_IsLost(p) (p)->lpVtbl->IsLost(p)
#define IDirectDrawSurface_Lock(p,a,b,c,d) (p)->lpVtbl->Lock(p,a,b,c,d)
#define IDirectDrawSurface_ReleaseDC(p,a) (p)->lpVtbl->ReleaseDC(p,a)
#define IDirectDrawSurface_Restore(p) (p)->lpVtbl->Restore(p)
#define IDirectDrawSurface_SetClipper(p,a) (p)->lpVtbl->SetClipper(p,a)
#define IDirectDrawSurface_SetColorKey(p,a,b) (p)->lpVtbl->SetColorKey(p,a,b)
#define IDirectDrawSurface_SetOverlayPosition(p,a,b) (p)->lpVtbl->SetOverlayPosition(p,a,b)
#define IDirectDrawSurface_SetPalette(p,a) (p)->lpVtbl->SetPalette(p,a)
#define IDirectDrawSurface_Unlock(p,b) (p)->lpVtbl->Unlock(p,b)
#define IDirectDrawSurface_UpdateOverlay(p,a,b,c,d,e) (p)->lpVtbl->UpdateOverlay(p,a,b,c,d,e)
#define IDirectDrawSurface_UpdateOverlayDisplay(p,a) (p)->lpVtbl->UpdateOverlayDisplay(p,a)
#define IDirectDrawSurface_UpdateOverlayZOrder(p,a,b) (p)->lpVtbl->UpdateOverlayZOrder(p,a,b)
#endif
/*
* IDirectDrawSurface2 and related interfaces */#undef INTERFACE
#define INTERFACE IDirectDrawSurface2
DECLARE_INTERFACE_( IDirectDrawSurface2, IUnknown ){ /*** IUnknown methods ***/ STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE; STDMETHOD_(ULONG,AddRef) (THIS) PURE; STDMETHOD_(ULONG,Release) (THIS) PURE; /*** IDirectDrawSurface methods ***/ STDMETHOD(AddAttachedSurface)(THIS_ LPDIRECTDRAWSURFACE2) PURE; STDMETHOD(AddOverlayDirtyRect)(THIS_ LPRECT) PURE; STDMETHOD(Blt)(THIS_ LPRECT,LPDIRECTDRAWSURFACE2, LPRECT,DWORD, LPDDBLTFX) PURE; STDMETHOD(BltBatch)(THIS_ LPDDBLTBATCH, DWORD, DWORD ) PURE; STDMETHOD(BltFast)(THIS_ DWORD,DWORD,LPDIRECTDRAWSURFACE2, LPRECT,DWORD) PURE; STDMETHOD(DeleteAttachedSurface)(THIS_ DWORD,LPDIRECTDRAWSURFACE2) PURE; STDMETHOD(EnumAttachedSurfaces)(THIS_ LPVOID,LPDDENUMSURFACESCALLBACK) PURE; STDMETHOD(EnumOverlayZOrders)(THIS_ DWORD,LPVOID,LPDDENUMSURFACESCALLBACK) PURE; STDMETHOD(Flip)(THIS_ LPDIRECTDRAWSURFACE2, DWORD) PURE; STDMETHOD(GetAttachedSurface)(THIS_ LPDDSCAPS, LPDIRECTDRAWSURFACE2 FAR *) PURE; STDMETHOD(GetBltStatus)(THIS_ DWORD) PURE; STDMETHOD(GetCaps)(THIS_ LPDDSCAPS) PURE; STDMETHOD(GetClipper)(THIS_ LPDIRECTDRAWCLIPPER FAR*) PURE; STDMETHOD(GetColorKey)(THIS_ DWORD, LPDDCOLORKEY) PURE; STDMETHOD(GetDC)(THIS_ HDC FAR *) PURE; STDMETHOD(GetFlipStatus)(THIS_ DWORD) PURE; STDMETHOD(GetOverlayPosition)(THIS_ LPLONG, LPLONG ) PURE; STDMETHOD(GetPalette)(THIS_ LPDIRECTDRAWPALETTE FAR*) PURE; STDMETHOD(GetPixelFormat)(THIS_ LPDDPIXELFORMAT) PURE; STDMETHOD(GetSurfaceDesc)(THIS_ LPDDSURFACEDESC) PURE; STDMETHOD(Initialize)(THIS_ LPDIRECTDRAW, LPDDSURFACEDESC) PURE; STDMETHOD(IsLost)(THIS) PURE; STDMETHOD(Lock)(THIS_ LPRECT,LPDDSURFACEDESC,DWORD,HANDLE) PURE; STDMETHOD(ReleaseDC)(THIS_ HDC) PURE; STDMETHOD(Restore)(THIS) PURE; STDMETHOD(SetClipper)(THIS_ LPDIRECTDRAWCLIPPER) PURE; STDMETHOD(SetColorKey)(THIS_ DWORD, LPDDCOLORKEY) PURE; STDMETHOD(SetOverlayPosition)(THIS_ LONG, LONG ) PURE; STDMETHOD(SetPalette)(THIS_ LPDIRECTDRAWPALETTE) PURE; STDMETHOD(Unlock)(THIS_ LPVOID) PURE; STDMETHOD(UpdateOverlay)(THIS_ LPRECT, LPDIRECTDRAWSURFACE2,LPRECT,DWORD, LPDDOVERLAYFX) PURE; STDMETHOD(UpdateOverlayDisplay)(THIS_ DWORD) PURE; STDMETHOD(UpdateOverlayZOrder)(THIS_ DWORD, LPDIRECTDRAWSURFACE2) PURE; /*** Added in the v2 interface ***/ STDMETHOD(GetDDInterface)(THIS_ LPVOID FAR *) PURE; STDMETHOD(PageLock)(THIS_ DWORD) PURE; STDMETHOD(PageUnlock)(THIS_ DWORD) PURE;};
#if !defined(__cplusplus) || defined(CINTERFACE)
#define IDirectDrawSurface2_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
#define IDirectDrawSurface2_AddRef(p) (p)->lpVtbl->AddRef(p)
#define IDirectDrawSurface2_Release(p) (p)->lpVtbl->Release(p)
#define IDirectDrawSurface2_AddAttachedSurface(p,a) (p)->lpVtbl->AddAttachedSurface(p,a)
#define IDirectDrawSurface2_AddOverlayDirtyRect(p,a) (p)->lpVtbl->AddOverlayDirtyRect(p,a)
#define IDirectDrawSurface2_Blt(p,a,b,c,d,e) (p)->lpVtbl->Blt(p,a,b,c,d,e)
#define IDirectDrawSurface2_BltBatch(p,a,b,c) (p)->lpVtbl->BltBatch(p,a,b,c)
#define IDirectDrawSurface2_BltFast(p,a,b,c,d,e) (p)->lpVtbl->BltFast(p,a,b,c,d,e)
#define IDirectDrawSurface2_DeleteAttachedSurface(p,a,b) (p)->lpVtbl->DeleteAttachedSurface(p,a,b)
#define IDirectDrawSurface2_EnumAttachedSurfaces(p,a,b) (p)->lpVtbl->EnumAttachedSurfaces(p,a,b)
#define IDirectDrawSurface2_EnumOverlayZOrders(p,a,b,c) (p)->lpVtbl->EnumOverlayZOrders(p,a,b,c)
#define IDirectDrawSurface2_Flip(p,a,b) (p)->lpVtbl->Flip(p,a,b)
#define IDirectDrawSurface2_GetAttachedSurface(p,a,b) (p)->lpVtbl->GetAttachedSurface(p,a,b)
#define IDirectDrawSurface2_GetBltStatus(p,a) (p)->lpVtbl->GetBltStatus(p,a)
#define IDirectDrawSurface2_GetCaps(p,b) (p)->lpVtbl->GetCaps(p,b)
#define IDirectDrawSurface2_GetClipper(p,a) (p)->lpVtbl->GetClipper(p,a)
#define IDirectDrawSurface2_GetColorKey(p,a,b) (p)->lpVtbl->GetColorKey(p,a,b)
#define IDirectDrawSurface2_GetDC(p,a) (p)->lpVtbl->GetDC(p,a)
#define IDirectDrawSurface2_GetFlipStatus(p,a) (p)->lpVtbl->GetFlipStatus(p,a)
#define IDirectDrawSurface2_GetOverlayPosition(p,a,b) (p)->lpVtbl->GetOverlayPosition(p,a,b)
#define IDirectDrawSurface2_GetPalette(p,a) (p)->lpVtbl->GetPalette(p,a)
#define IDirectDrawSurface2_GetPixelFormat(p,a) (p)->lpVtbl->GetPixelFormat(p,a)
#define IDirectDrawSurface2_GetSurfaceDesc(p,a) (p)->lpVtbl->GetSurfaceDesc(p,a)
#define IDirectDrawSurface2_Initialize(p,a,b) (p)->lpVtbl->Initialize(p,a,b)
#define IDirectDrawSurface2_IsLost(p) (p)->lpVtbl->IsLost(p)
#define IDirectDrawSurface2_Lock(p,a,b,c,d) (p)->lpVtbl->Lock(p,a,b,c,d)
#define IDirectDrawSurface2_ReleaseDC(p,a) (p)->lpVtbl->ReleaseDC(p,a)
#define IDirectDrawSurface2_Restore(p) (p)->lpVtbl->Restore(p)
#define IDirectDrawSurface2_SetClipper(p,a) (p)->lpVtbl->SetClipper(p,a)
#define IDirectDrawSurface2_SetColorKey(p,a,b) (p)->lpVtbl->SetColorKey(p,a,b)
#define IDirectDrawSurface2_SetOverlayPosition(p,a,b) (p)->lpVtbl->SetOverlayPosition(p,a,b)
#define IDirectDrawSurface2_SetPalette(p,a) (p)->lpVtbl->SetPalette(p,a)
#define IDirectDrawSurface2_Unlock(p,b) (p)->lpVtbl->Unlock(p,b)
#define IDirectDrawSurface2_UpdateOverlay(p,a,b,c,d,e) (p)->lpVtbl->UpdateOverlay(p,a,b,c,d,e)
#define IDirectDrawSurface2_UpdateOverlayDisplay(p,a) (p)->lpVtbl->UpdateOverlayDisplay(p,a)
#define IDirectDrawSurface2_UpdateOverlayZOrder(p,a,b) (p)->lpVtbl->UpdateOverlayZOrder(p,a,b)
#define IDirectDrawSurface2_GetDDInterface(p,a) (p)->lpVtbl->GetDDInterface(p,a)
#define IDirectDrawSurface2_PageLock(p,a) (p)->lpVtbl->PageLock(p,a)
#define IDirectDrawSurface2_PageUnlock(p,a) (p)->lpVtbl->PageUnlock(p,a)
#endif
//@@BEGIN_MSINTERNAL
#ifdef COMPOSITION
#undef INTERFACE
#define INTERFACE IDirectDrawSurfaceComposition
DECLARE_INTERFACE_( IDirectDrawSurfaceComposition, IUnknown ){ /*** IUnknown methods ***/ STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE; STDMETHOD_(ULONG,AddRef) (THIS) PURE; STDMETHOD_(ULONG,Release) (THIS) PURE; /*** IDirectDrawSurfaceComposition methods ***/ STDMETHOD(AddSurfaceDependency)(THIS_ LPDIRECTDRAWSURFACE) PURE; STDMETHOD(Compose)(THIS_ LPRECT,LPDIRECTDRAWSURFACE,LPRECT,DWORD,LPDDCOMPOSEFX) PURE; STDMETHOD(DeleteSurfaceDependency)(THIS_ DWORD,LPDIRECTDRAWSURFACE) PURE; STDMETHOD(DestLock)(THIS) PURE; STDMETHOD(DestUnlock)(THIS) PURE; STDMETHOD(EnumSurfaceDependencies)(THIS_ LPVOID,LPDDENUMSURFACESCALLBACK) PURE; STDMETHOD(GetCompositionOrder)(THIS_ LPDWORD) PURE; STDMETHOD(SetCompositionOrder)(THIS_ DWORD) PURE;};#endif
#ifdef STREAMING
#undef INTERFACE
#define INTERFACE IDirectDrawSurfaceStreaming
DECLARE_INTERFACE_( IDirectDrawSurfaceStreaming, IUnknown ){ /*** IUnknown methods ***/ STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE; STDMETHOD_(ULONG,AddRef) (THIS) PURE; STDMETHOD_(ULONG,Release) (THIS) PURE; /*** IDirectDrawSurfaceStreaming methods ***/ STDMETHOD(Lock)(THIS_ LPRECT,LPDDSURFACEDESC,DWORD,HANDLE) PURE; STDMETHOD(SetNotificationCallback)(THIS_ DWORD,LPSURFACESTREAMINGCALLBACK) PURE; STDMETHOD(Unlock)(THIS_ LPVOID) PURE;};#endif
//@@END_MSINTERNAL
#endif
//@@BEGIN_MSINTERNAL
#ifdef CLIPPER_NOTIFY
/*
* DIRECTDRAWCLIPPER FLAGS */#define DDCLIPPER_WATCHWINDOW 0x00000001l
#endif
//@@END_MSINTERNAL
/*
* DDSURFACEDESC */typedef struct _DDSURFACEDESC{ DWORD dwSize; // size of the DDSURFACEDESC structure
DWORD dwFlags; // determines what fields are valid
DWORD dwHeight; // height of surface to be created
DWORD dwWidth; // width of input surface
LONG lPitch; // distance to start of next line (return value only)
DWORD dwBackBufferCount; // number of back buffers requested
union { DWORD dwMipMapCount; // number of mip-map levels requested
DWORD dwZBufferBitDepth; // depth of Z buffer requested
DWORD dwRefreshRate; // refresh rate (used when display mode is described)
}; DWORD dwAlphaBitDepth; // depth of alpha buffer requested
//@@BEGIN_MSINTERNAL
#ifdef COMPOSITION
DWORD dwCompositionOrder; // blt order for the surface, 0 is background
#else
//@@END_MSINTERNAL
DWORD dwReserved; // reserved
//@@BEGIN_MSINTERNAL
#endif
//@@END_MSINTERNAL
LPVOID lpSurface; // pointer to the associated surface memory
DDCOLORKEY ddckCKDestOverlay; // color key for destination overlay use
DDCOLORKEY ddckCKDestBlt; // color key for destination blt use
DDCOLORKEY ddckCKSrcOverlay; // color key for source overlay use
DDCOLORKEY ddckCKSrcBlt; // color key for source blt use
DDPIXELFORMAT ddpfPixelFormat; // pixel format description of the surface
DDSCAPS ddsCaps; // direct draw surface capabilities
} DDSURFACEDESC;
/*
* ddsCaps field is valid. */#define DDSD_CAPS 0x00000001l // default
/*
* dwHeight field is valid. */#define DDSD_HEIGHT 0x00000002l
/*
* dwWidth field is valid. */#define DDSD_WIDTH 0x00000004l
/*
* lPitch is valid. */#define DDSD_PITCH 0x00000008l
/*
* dwBackBufferCount is valid. */#define DDSD_BACKBUFFERCOUNT 0x00000020l
/*
* dwZBufferBitDepth is valid. */#define DDSD_ZBUFFERBITDEPTH 0x00000040l
/*
* dwAlphaBitDepth is valid. */#define DDSD_ALPHABITDEPTH 0x00000080l
//@@BEGIN_MSINTERNAL
#ifdef COMPOSITION
/*
* dwCompositionOrder is valid. */#define DDSD_COMPOSITIONORDER 0x00000100l
#endif
//@@END_MSINTERNAL
//@@BEGIN_MSINTERNAL
/*
* lpSurface is valid. */#define DDSD_LPSURFACE 0x00000800l
//@@END_MSINTERNAL
/*
* ddpfPixelFormat is valid. */#define DDSD_PIXELFORMAT 0x00001000l
/*
* ddckCKDestOverlay is valid. */#define DDSD_CKDESTOVERLAY 0x00002000l
/*
* ddckCKDestBlt is valid. */#define DDSD_CKDESTBLT 0x00004000l
/*
* ddckCKSrcOverlay is valid. */#define DDSD_CKSRCOVERLAY 0x00008000l
/*
* ddckCKSrcBlt is valid. */#define DDSD_CKSRCBLT 0x00010000l
/*
* dwMipMapCount is valid. */#define DDSD_MIPMAPCOUNT 0x00020000l
/*
* dwRefreshRate is valid */#define DDSD_REFRESHRATE 0x00040000l
/*
* All input fields are valid. */#define DDSD_ALL 0x0007f9eel
//@@BEGIN_MSINTERNAL
/*
* DDMODEDESC */typedef struct _DDMODEDESC{ DWORD dwSize; // size of structure
DWORD dwFlags; // enumeration flags
DWORD dwMonitorFrequency; // frequency of monitor in mode
DDSURFACEDESC ddsdSurfaceDesc; // surface being enumerated
} DDMODEDESC;
typedef DDMODEDESC FAR* LPDDMODEDESC;//@@END_MSINTERNAL
/*============================================================================
* * Direct Draw Capability Flags * * These flags are used to describe the capabilities of a given Surface. * All flags are bit flags. * *==========================================================================*/
/****************************************************************************
* * DIRECTDRAWSURFACE CAPABILITY FLAGS * ****************************************************************************//*
* This bit currently has no meaning. */#define DDSCAPS_3D 0x00000001l
/*
* Indicates that this surface contains alpha information. The pixel * format must be interrogated to determine whether this surface * contains only alpha information or alpha information interlaced * with pixel color data (e.g. RGBA or YUVA). */#define DDSCAPS_ALPHA 0x00000002l
/*
* Indicates that this surface is a backbuffer. It is generally * set by CreateSurface when the DDSCAPS_FLIP capability bit is set. * It indicates that this surface is THE back buffer of a surface * flipping structure. DirectDraw supports N surfaces in a * surface flipping structure. Only the surface that immediately * precedeces the DDSCAPS_FRONTBUFFER has this capability bit set. * The other surfaces are identified as back buffers by the presence * of the DDSCAPS_FLIP capability, their attachment order, and the * absence of the DDSCAPS_FRONTBUFFER and DDSCAPS_BACKBUFFER * capabilities. The bit is sent to CreateSurface when a standalone * back buffer is being created. This surface could be attached to * a front buffer and/or back buffers to form a flipping surface * structure after the CreateSurface call. See AddAttachments for * a detailed description of the behaviors in this case. */#define DDSCAPS_BACKBUFFER 0x00000004l
/*
* Indicates a complex surface structure is being described. A * complex surface structure results in the creation of more than * one surface. The additional surfaces are attached to the root * surface. The complex structure can only be destroyed by * destroying the root. */#define DDSCAPS_COMPLEX 0x00000008l
/*
* Indicates that this surface is a part of a surface flipping structure. * When it is passed to CreateSurface the DDSCAPS_FRONTBUFFER and * DDSCAP_BACKBUFFER bits are not set. They are set by CreateSurface * on the resulting creations. The dwBackBufferCount field in the * DDSURFACEDESC structure must be set to at least 1 in order for * the CreateSurface call to succeed. The DDSCAPS_COMPLEX capability * must always be set with creating multiple surfaces through CreateSurface. */#define DDSCAPS_FLIP 0x00000010l
/*
* Indicates that this surface is THE front buffer of a surface flipping * structure. It is generally set by CreateSurface when the DDSCAPS_FLIP * capability bit is set. * If this capability is sent to CreateSurface then a standalonw front buffer * is created. This surface will not have the DDSCAPS_FLIP capability. * It can be attached to other back buffers to form a flipping structure. * See AddAttachments for a detailed description of the behaviors in this * case. */#define DDSCAPS_FRONTBUFFER 0x00000020l
/*
* Indicates that this surface is any offscreen surface that is not an overlay, * texture, zbuffer, front buffer, back buffer, or alpha surface. It is used * to identify plain vanilla surfaces. */#define DDSCAPS_OFFSCREENPLAIN 0x00000040l
/*
* Indicates that this surface is an overlay. It may or may not be directly visible * depending on whether or not it is currently being overlayed onto the primary * surface. DDSCAPS_VISIBLE can be used to determine whether or not it is being * overlayed at the moment. */#define DDSCAPS_OVERLAY 0x00000080l
/*
* Indicates that unique DirectDrawPalette objects can be created and * attached to this surface. */#define DDSCAPS_PALETTE 0x00000100l
/*
* Indicates that this surface is the primary surface. The primary * surface represents what the user is seeing at the moment. */#define DDSCAPS_PRIMARYSURFACE 0x00000200l
/*
* Indicates that this surface is the primary surface for the left eye. * The primary surface for the left eye represents what the user is seeing * at the moment with the users left eye. When this surface is created the * DDSCAPS_PRIMARYSURFACE represents what the user is seeing with the users * right eye. */#define DDSCAPS_PRIMARYSURFACELEFT 0x00000400l
/*
* Indicates that this surface memory was allocated in system memory */#define DDSCAPS_SYSTEMMEMORY 0x00000800l
/*
* Indicates that this surface can be used as a 3D texture. It does not * indicate whether or not the surface is being used for that purpose. */#define DDSCAPS_TEXTURE 0x00001000l
/*
* Indicates that a surface may be a destination for 3D rendering. This * bit must be set in order to query for a Direct3D Device Interface * from this surface. */#define DDSCAPS_3DDEVICE 0x00002000l
/*
* Indicates that this surface exists in video memory. */#define DDSCAPS_VIDEOMEMORY 0x00004000l
/*
* Indicates that changes made to this surface are immediately visible. * It is always set for the primary surface and is set for overlays while * they are being overlayed and texture maps while they are being textured. */#define DDSCAPS_VISIBLE 0x00008000l
/*
* Indicates that only writes are permitted to the surface. Read accesses * from the surface may or may not generate a protection fault, but the * results of a read from this surface will not be meaningful. READ ONLY. */#define DDSCAPS_WRITEONLY 0x00010000l
/*
* Indicates that this surface is a z buffer. A z buffer does not contain * displayable information. Instead it contains bit depth information that is * used to determine which pixels are visible and which are obscured. */#define DDSCAPS_ZBUFFER 0x00020000l
/*
* Indicates surface will have a DC associated long term */#define DDSCAPS_OWNDC 0x00040000l
/*
* Indicates surface should be able to receive live video */#define DDSCAPS_LIVEVIDEO 0x00080000l
/*
* Indicates surface should be able to have a stream decompressed * to it by the hardware. */#define DDSCAPS_HWCODEC 0x00100000l
/*
* Surface is a 320x200 or 320x240 ModeX surface */#define DDSCAPS_MODEX 0x00200000l
/*
* Indicates surface is one level of a mip-map. This surface will * be attached to other DDSCAPS_MIPMAP surfaces to form the mip-map. * This can be done explicitly, by creating a number of surfaces and * attaching them with AddAttachedSurface or by implicitly by CreateSurface. * If this bit is set then DDSCAPS_TEXTURE must also be set. */#define DDSCAPS_MIPMAP 0x00400000l
//@@BEGIN_MSINTERNAL
/*
* Indicates the surface is an execute buffer, i.e., a linear chunk of system * or video memory that holds a Direct3D display list. This cap. is MS internal * only as Direct3D will use it to create surfaces but it is not externally * visible via the DirectDraw API. */#define DDSCAPS_EXECUTEBUFFER 0x00800000l
//@@END_MSINTERNAL
//@@BEGIN_MSINTERNAL
#ifdef SHAREDZ
/*
* Indicates that this Z buffer surface can be shared with other DirectDraw * applications. This does not necessarily mean that this surface is * currently being shared with other processes but only that it can be. If * this bit is set then DDSCAPS_ZBUFFER must also be set. */#define DDSCAPS_SHAREDZBUFFER 0x01000000l
/*
* Indicates that this backbuffer surface can be shared with other DirectDraw * applications. This does not necessarily mean that this surface is * currently being shared with other processes but only that it can be. If * this bit is set than DDSCAPS_BACKBUFFER must also be set (it may also be * set if a backbuffer is being created implicitly with as past of a complex * flippable chain). */#define DDSCAPS_SHAREDBACKBUFFER 0x02000000l
#endif
//@@END_MSINTERNAL
/*
* Indicates that memory for the surface is not allocated until the surface * is loaded (via the Direct3D texture Load() function). */#define DDSCAPS_ALLOCONLOAD 0x04000000l
//@@BEGIN_MSINTERNAL
#ifdef SHAREDZ
#define DDSCAPS_VALID 0x07ffffffl
#else
#define DDSCAPS_VALID 0x04ffffffl
#endif
//@@END_MSINTERNAL
/****************************************************************************
* * DIRECTDRAW DRIVER CAPABILITY FLAGS * ****************************************************************************/
/*
* Display hardware has 3D acceleration. */#define DDCAPS_3D 0x00000001l
/*
* Indicates that DirectDraw will support only dest rectangles that are aligned * on DIRECTDRAWCAPS.dwAlignBoundaryDest boundaries of the surface, respectively. * READ ONLY. */#define DDCAPS_ALIGNBOUNDARYDEST 0x00000002l
/*
* Indicates that DirectDraw will support only source rectangles whose sizes in * BYTEs are DIRECTDRAWCAPS.dwAlignSizeDest multiples, respectively. READ ONLY. */#define DDCAPS_ALIGNSIZEDEST 0x00000004l
/*
* Indicates that DirectDraw will support only source rectangles that are aligned * on DIRECTDRAWCAPS.dwAlignBoundarySrc boundaries of the surface, respectively. * READ ONLY. */#define DDCAPS_ALIGNBOUNDARYSRC 0x00000008l
/*
* Indicates that DirectDraw will support only source rectangles whose sizes in * BYTEs are DIRECTDRAWCAPS.dwAlignSizeSrc multiples, respectively. READ ONLY. */#define DDCAPS_ALIGNSIZESRC 0x00000010l
/*
* Indicates that DirectDraw will create video memory surfaces that have a stride * alignment equal to DIRECTDRAWCAPS.dwAlignStride. READ ONLY. */#define DDCAPS_ALIGNSTRIDE 0x00000020l
/*
* Display hardware is capable of blt operations. */#define DDCAPS_BLT 0x00000040l
/*
* Display hardware is capable of asynchronous blt operations. */#define DDCAPS_BLTQUEUE 0x00000080l
/*
* Display hardware is capable of color space conversions during the blt operation. */#define DDCAPS_BLTFOURCC 0x00000100l
/*
* Display hardware is capable of stretching during blt operations. */#define DDCAPS_BLTSTRETCH 0x00000200l
/*
* Display hardware is shared with GDI. */#define DDCAPS_GDI 0x00000400l
/*
* Display hardware can overlay. */#define DDCAPS_OVERLAY 0x00000800l
/*
* Set if display hardware supports overlays but can not clip them. */#define DDCAPS_OVERLAYCANTCLIP 0x00001000l
/*
* Indicates that overlay hardware is capable of color space conversions during * the overlay operation. */#define DDCAPS_OVERLAYFOURCC 0x00002000l
/*
* Indicates that stretching can be done by the overlay hardware. */#define DDCAPS_OVERLAYSTRETCH 0x00004000l
/*
* Indicates that unique DirectDrawPalettes can be created for DirectDrawSurfaces * other than the primary surface. */#define DDCAPS_PALETTE 0x00008000l
/*
* Indicates that palette changes can be syncd with the veritcal refresh. */#define DDCAPS_PALETTEVSYNC 0x00010000l
/*
* Display hardware can return the current scan line. */#define DDCAPS_READSCANLINE 0x00020000l
/*
* Display hardware has stereo vision capabilities. DDSCAPS_PRIMARYSURFACELEFT * can be created. */#define DDCAPS_STEREOVIEW 0x00040000l
/*
* Display hardware is capable of generating a vertical blank interrupt. */#define DDCAPS_VBI 0x00080000l
/*
* Supports the use of z buffers with blt operations. */#define DDCAPS_ZBLTS 0x00100000l
/*
* Supports Z Ordering of overlays. */#define DDCAPS_ZOVERLAYS 0x00200000l
/*
* Supports color key */#define DDCAPS_COLORKEY 0x00400000l
/*
* Supports alpha surfaces */#define DDCAPS_ALPHA 0x00800000l
/*
* colorkey is hardware assisted(DDCAPS_COLORKEY will also be set) */#define DDCAPS_COLORKEYHWASSIST 0x01000000l
/*
* no hardware support at all */#define DDCAPS_NOHARDWARE 0x02000000l
/*
* Display hardware is capable of color fill with bltter */#define DDCAPS_BLTCOLORFILL 0x04000000l
/*
* Display hardware is bank switched, and potentially very slow at * random access to VRAM. */#define DDCAPS_BANKSWITCHED 0x08000000l
/*
* Display hardware is capable of depth filling Z-buffers with bltter */#define DDCAPS_BLTDEPTHFILL 0x10000000l
/*
* Display hardware is capable of clipping while bltting. */#define DDCAPS_CANCLIP 0x20000000l
/*
* Display hardware is capable of clipping while stretch bltting. */#define DDCAPS_CANCLIPSTRETCHED 0x40000000l
/*
* Display hardware is capable of bltting to or from system memory */#define DDCAPS_CANBLTSYSMEM 0x80000000l
/****************************************************************************
* * MORE DIRECTDRAW DRIVER CAPABILITY FLAGS (dwCaps2) * ****************************************************************************/
/*
* Display hardware is certified */#define DDCAPS2_CERTIFIED 0x00000001l
/*
* Driver cannot interleave 2D operations (lock and blt) to surfaces with * Direct3D rendering operations between calls to BeginScene() and EndScene() */#define DDCAPS2_NO2DDURING3DSCENE 0x00000002l
/****************************************************************************
* * DIRECTDRAW FX ALPHA CAPABILITY FLAGS * ****************************************************************************/
/*
* Supports alpha blending around the edge of a source color keyed surface. * For Blt. */#define DDFXALPHACAPS_BLTALPHAEDGEBLEND 0x00000001l
/*
* Supports alpha information in the pixel format. The bit depth of alpha * information in the pixel format can be 1,2,4, or 8. The alpha value becomes * more opaque as the alpha value increases. (0 is transparent.) * For Blt. */#define DDFXALPHACAPS_BLTALPHAPIXELS 0x00000002l
/*
* Supports alpha information in the pixel format. The bit depth of alpha * information in the pixel format can be 1,2,4, or 8. The alpha value * becomes more transparent as the alpha value increases. (0 is opaque.) * This flag can only be set if DDCAPS_ALPHA is set. * For Blt. */#define DDFXALPHACAPS_BLTALPHAPIXELSNEG 0x00000004l
/*
* Supports alpha only surfaces. The bit depth of an alpha only surface can be * 1,2,4, or 8. The alpha value becomes more opaque as the alpha value increases. * (0 is transparent.) * For Blt. */#define DDFXALPHACAPS_BLTALPHASURFACES 0x00000008l
/*
* The depth of the alpha channel data can range can be 1,2,4, or 8. * The NEG suffix indicates that this alpha channel becomes more transparent * as the alpha value increases. (0 is opaque.) This flag can only be set if * DDCAPS_ALPHA is set. * For Blt. */#define DDFXALPHACAPS_BLTALPHASURFACESNEG 0x00000010l
/*
* Supports alpha blending around the edge of a source color keyed surface. * For Overlays. */#define DDFXALPHACAPS_OVERLAYALPHAEDGEBLEND 0x00000020l
/*
* Supports alpha information in the pixel format. The bit depth of alpha * information in the pixel format can be 1,2,4, or 8. The alpha value becomes * more opaque as the alpha value increases. (0 is transparent.) * For Overlays. */#define DDFXALPHACAPS_OVERLAYALPHAPIXELS 0x00000040l
/*
* Supports alpha information in the pixel format. The bit depth of alpha * information in the pixel format can be 1,2,4, or 8. The alpha value * becomes more transparent as the alpha value increases. (0 is opaque.) * This flag can only be set if DDCAPS_ALPHA is set. * For Overlays. */#define DDFXALPHACAPS_OVERLAYALPHAPIXELSNEG 0x00000080l
/*
* Supports alpha only surfaces. The bit depth of an alpha only surface can be * 1,2,4, or 8. The alpha value becomes more opaque as the alpha value increases. * (0 is transparent.) * For Overlays. */#define DDFXALPHACAPS_OVERLAYALPHASURFACES 0x00000100l
/*
* The depth of the alpha channel data can range can be 1,2,4, or 8. * The NEG suffix indicates that this alpha channel becomes more transparent * as the alpha value increases. (0 is opaque.) This flag can only be set if * DDCAPS_ALPHA is set. * For Overlays. */#define DDFXALPHACAPS_OVERLAYALPHASURFACESNEG 0x00000200l
/****************************************************************************
* * DIRECTDRAW FX CAPABILITY FLAGS * ****************************************************************************/
/*
* Uses arithmetic operations to stretch and shrink surfaces during blt * rather than pixel doubling techniques. Along the Y axis. */#define DDFXCAPS_BLTARITHSTRETCHY 0x00000020l
/*
* Uses arithmetic operations to stretch during blt * rather than pixel doubling techniques. Along the Y axis. Only * works for x1, x2, etc. */#define DDFXCAPS_BLTARITHSTRETCHYN 0x00000010l
/*
* Supports mirroring left to right in blt. */#define DDFXCAPS_BLTMIRRORLEFTRIGHT 0x00000040l
/*
* Supports mirroring top to bottom in blt. */#define DDFXCAPS_BLTMIRRORUPDOWN 0x00000080l
/*
* Supports arbitrary rotation for blts. */#define DDFXCAPS_BLTROTATION 0x00000100l
/*
* Supports 90 degree rotations for blts. */#define DDFXCAPS_BLTROTATION90 0x00000200l
/*
* DirectDraw supports arbitrary shrinking of a surface along the * x axis (horizontal direction) for blts. */#define DDFXCAPS_BLTSHRINKX 0x00000400l
/*
* DirectDraw supports integer shrinking (1x,2x,) of a surface * along the x axis (horizontal direction) for blts. */#define DDFXCAPS_BLTSHRINKXN 0x00000800l
/*
* DirectDraw supports arbitrary shrinking of a surface along the * y axis (horizontal direction) for blts. */#define DDFXCAPS_BLTSHRINKY 0x00001000l
/*
* DirectDraw supports integer shrinking (1x,2x,) of a surface * along the y axis (vertical direction) for blts. */#define DDFXCAPS_BLTSHRINKYN 0x00002000l
/*
* DirectDraw supports arbitrary stretching of a surface along the * x axis (horizontal direction) for blts. */#define DDFXCAPS_BLTSTRETCHX 0x00004000l
/*
* DirectDraw supports integer stretching (1x,2x,) of a surface * along the x axis (horizontal direction) for blts. */#define DDFXCAPS_BLTSTRETCHXN 0x00008000l
/*
* DirectDraw supports arbitrary stretching of a surface along the * y axis (horizontal direction) for blts. */#define DDFXCAPS_BLTSTRETCHY 0x00010000l
/*
* DirectDraw supports integer stretching (1x,2x,) of a surface * along the y axis (vertical direction) for blts. */#define DDFXCAPS_BLTSTRETCHYN 0x00020000l
/*
* Uses arithmetic operations to stretch and shrink surfaces during * overlay rather than pixel doubling techniques. Along the Y axis * for overlays. */#define DDFXCAPS_OVERLAYARITHSTRETCHY 0x00040000l
/*
* Uses arithmetic operations to stretch surfaces during * overlay rather than pixel doubling techniques. Along the Y axis * for overlays. Only works for x1, x2, etc. */#define DDFXCAPS_OVERLAYARITHSTRETCHYN 0x00000008l
/*
* DirectDraw supports arbitrary shrinking of a surface along the * x axis (horizontal direction) for overlays. */#define DDFXCAPS_OVERLAYSHRINKX 0x00080000l
/*
* DirectDraw supports integer shrinking (1x,2x,) of a surface * along the x axis (horizontal direction) for overlays. */#define DDFXCAPS_OVERLAYSHRINKXN 0x00100000l
/*
* DirectDraw supports arbitrary shrinking of a surface along the * y axis (horizontal direction) for overlays. */#define DDFXCAPS_OVERLAYSHRINKY 0x00200000l
/*
* DirectDraw supports integer shrinking (1x,2x,) of a surface * along the y axis (vertical direction) for overlays. */#define DDFXCAPS_OVERLAYSHRINKYN 0x00400000l
/*
* DirectDraw supports arbitrary stretching of a surface along the * x axis (horizontal direction) for overlays. */#define DDFXCAPS_OVERLAYSTRETCHX 0x00800000l
/*
* DirectDraw supports integer stretching (1x,2x,) of a surface * along the x axis (horizontal direction) for overlays. */#define DDFXCAPS_OVERLAYSTRETCHXN 0x01000000l
/*
* DirectDraw supports arbitrary stretching of a surface along the * y axis (horizontal direction) for overlays. */#define DDFXCAPS_OVERLAYSTRETCHY 0x02000000l
/*
* DirectDraw supports integer stretching (1x,2x,) of a surface * along the y axis (vertical direction) for overlays. */#define DDFXCAPS_OVERLAYSTRETCHYN 0x04000000l
/*
* DirectDraw supports mirroring of overlays across the vertical axis */#define DDFXCAPS_OVERLAYMIRRORLEFTRIGHT 0x08000000l
/*
* DirectDraw supports mirroring of overlays across the horizontal axis */#define DDFXCAPS_OVERLAYMIRRORUPDOWN 0x10000000l
/****************************************************************************
* * DIRECTDRAW STEREO VIEW CAPABILITIES * ****************************************************************************/
/*
* The stereo view is accomplished via enigma encoding. */#define DDSVCAPS_ENIGMA 0x00000001l
/*
* The stereo view is accomplished via high frequency flickering. */#define DDSVCAPS_FLICKER 0x00000002l
/*
* The stereo view is accomplished via red and blue filters applied * to the left and right eyes. All images must adapt their colorspaces * for this process. */#define DDSVCAPS_REDBLUE 0x00000004l
/*
* The stereo view is accomplished with split screen technology. */#define DDSVCAPS_SPLIT 0x00000008l
/****************************************************************************
* * DIRECTDRAWPALETTE CAPABILITIES * ****************************************************************************/
/*
* Index is 4 bits. There are sixteen color entries in the palette table. */#define DDPCAPS_4BIT 0x00000001l
/*
* Index is onto a 8 bit color index. This field is only valid with the * DDPCAPS_1BIT, DDPCAPS_2BIT or DDPCAPS_4BIT capability and the target * surface is in 8bpp. Each color entry is one byte long and is an index * into destination surface's 8bpp palette. */#define DDPCAPS_8BITENTRIES 0x00000002l
/*
* Index is 8 bits. There are 256 color entries in the palette table. */#define DDPCAPS_8BIT 0x00000004l
/*
* Indicates that this DIRECTDRAWPALETTE should use the palette color array * passed into the lpDDColorArray parameter to initialize the DIRECTDRAWPALETTE * object. */#define DDPCAPS_INITIALIZE 0x00000008l
/*
* This palette is the one attached to the primary surface. Changing this * table has immediate effect on the display unless DDPSETPAL_VSYNC is specified * and supported. */#define DDPCAPS_PRIMARYSURFACE 0x00000010l
/*
* This palette is the one attached to the primary surface left. Changing * this table has immediate effect on the display for the left eye unless * DDPSETPAL_VSYNC is specified and supported. */#define DDPCAPS_PRIMARYSURFACELEFT 0x00000020l
/*
* This palette can have all 256 entries defined */#define DDPCAPS_ALLOW256 0x00000040l
/*
* This palette can have modifications to it synced with the monitors * refresh rate. */#define DDPCAPS_VSYNC 0x00000080l
/*
* Index is 1 bit. There are two color entries in the palette table. */#define DDPCAPS_1BIT 0x00000100l
/*
* Index is 2 bit. There are four color entries in the palette table. */#define DDPCAPS_2BIT 0x00000200l
//@@BEGIN_MSINTERNAL
#define DDPCAPS_VALID 0x000003ffl
//@@END_MSINTERNAL
/****************************************************************************
* * DIRECTDRAWPALETTE SETENTRY CONSTANTS * ****************************************************************************/
//@@BEGIN_MSINTERNAL
/*
* Palette changes take effect immediately. */#define DDPSETPAL_IMMEDIATE 0x00000000l // default
/*
* Palette changes should take effect during the vertical blank to avoid * palette tearing. */#define DDPSETPAL_VSYNC 0x00000002l
//@@END_MSINTERNAL
/****************************************************************************
* * DIRECTDRAWPALETTE GETENTRY CONSTANTS * ****************************************************************************/
/* 0 is the only legal value */
/****************************************************************************
* * DIRECTDRAWSURFACE SETPALETTE CONSTANTS * ****************************************************************************/
//@@BEGIN_MSINTERNAL
/*
* Palette change takes effect immediately. */#define DDSETPAL_IMMEDIATE 0x00000000l // default
/*
* Palette change should take effect during the vertical blank to avoid * palette tearing. */#define DDSETPAL_VSYNC 0x00000002l
//@@END_MSINTERNAL
/****************************************************************************
* * DIRECTDRAW BITDEPTH CONSTANTS * * NOTE: These are only used to indicate supported bit depths. These * are flags only, they are not to be used as an actual bit depth. The * absolute numbers 1, 2, 4, 8, 16, 24 and 32 are used to indicate actual * bit depths in a surface or for changing the display mode. * ****************************************************************************/
/*
* 1 bit per pixel. */#define DDBD_1 0x00004000l
/*
* 2 bits per pixel. */#define DDBD_2 0x00002000l
/*
* 4 bits per pixel. */#define DDBD_4 0x00001000l
/*
* 8 bits per pixel. */#define DDBD_8 0x00000800l
/*
* 16 bits per pixel. */#define DDBD_16 0x00000400l
/*
* 24 bits per pixel. */#define DDBD_24 0X00000200l
/*
* 32 bits per pixel. */#define DDBD_32 0x00000100l
/****************************************************************************
* * DIRECTDRAWSURFACE SET/GET COLOR KEY FLAGS * ****************************************************************************/
/*
* Set if the structure contains a color space. Not set if the structure * contains a single color key. */#define DDCKEY_COLORSPACE 0x00000001l
/*
* Set if the structure specifies a color key or color space which is to be * used as a destination color key for blt operations. */#define DDCKEY_DESTBLT 0x00000002l
/*
* Set if the structure specifies a color key or color space which is to be * used as a destination color key for overlay operations. */#define DDCKEY_DESTOVERLAY 0x00000004l
/*
* Set if the structure specifies a color key or color space which is to be * used as a source color key for blt operations. */#define DDCKEY_SRCBLT 0x00000008l
/*
* Set if the structure specifies a color key or color space which is to be * used as a source color key for overlay operations. */#define DDCKEY_SRCOVERLAY 0x00000010l
//@@BEGIN_MSINTERNAL
#define DDCKEY_VALID 0x0000001fl
//@@END_MSINTERNAL
/****************************************************************************
* * DIRECTDRAW COLOR KEY CAPABILITY FLAGS * ****************************************************************************/
/*
* Supports transparent blting using a color key to identify the replaceable * bits of the destination surface for RGB colors. */#define DDCKEYCAPS_DESTBLT 0x00000001l
/*
* Supports transparent blting using a color space to identify the replaceable * bits of the destination surface for RGB colors. */#define DDCKEYCAPS_DESTBLTCLRSPACE 0x00000002l
/*
* Supports transparent blting using a color space to identify the replaceable * bits of the destination surface for YUV colors. */#define DDCKEYCAPS_DESTBLTCLRSPACEYUV 0x00000004l
/*
* Supports transparent blting using a color key to identify the replaceable * bits of the destination surface for YUV colors. */#define DDCKEYCAPS_DESTBLTYUV 0x00000008l
/*
* Supports overlaying using colorkeying of the replaceable bits of the surface * being overlayed for RGB colors. */#define DDCKEYCAPS_DESTOVERLAY 0x00000010l
/*
* Supports a color space as the color key for the destination for RGB colors. */#define DDCKEYCAPS_DESTOVERLAYCLRSPACE 0x00000020l
/*
* Supports a color space as the color key for the destination for YUV colors. */#define DDCKEYCAPS_DESTOVERLAYCLRSPACEYUV 0x00000040l
/*
* Supports only one active destination color key value for visible overlay * surfaces. */#define DDCKEYCAPS_DESTOVERLAYONEACTIVE 0x00000080l
/*
* Supports overlaying using colorkeying of the replaceable bits of the * surface being overlayed for YUV colors. */#define DDCKEYCAPS_DESTOVERLAYYUV 0x00000100l
/*
* Supports transparent blting using the color key for the source with * this surface for RGB colors. */#define DDCKEYCAPS_SRCBLT 0x00000200l
/*
* Supports transparent blting using a color space for the source with * this surface for RGB colors. */#define DDCKEYCAPS_SRCBLTCLRSPACE 0x00000400l
/*
* Supports transparent blting using a color space for the source with * this surface for YUV colors. */#define DDCKEYCAPS_SRCBLTCLRSPACEYUV 0x00000800l
/*
* Supports transparent blting using the color key for the source with * this surface for YUV colors. */#define DDCKEYCAPS_SRCBLTYUV 0x00001000l
/*
* Supports overlays using the color key for the source with this * overlay surface for RGB colors. */#define DDCKEYCAPS_SRCOVERLAY 0x00002000l
/*
* Supports overlays using a color space as the source color key for * the overlay surface for RGB colors. */#define DDCKEYCAPS_SRCOVERLAYCLRSPACE 0x00004000l
/*
* Supports overlays using a color space as the source color key for * the overlay surface for YUV colors. */#define DDCKEYCAPS_SRCOVERLAYCLRSPACEYUV 0x00008000l
/*
* Supports only one active source color key value for visible * overlay surfaces. */#define DDCKEYCAPS_SRCOVERLAYONEACTIVE 0x00010000l
/*
* Supports overlays using the color key for the source with this * overlay surface for YUV colors. */#define DDCKEYCAPS_SRCOVERLAYYUV 0x00020000l
/*
* there are no bandwidth trade-offs for using colorkey with an overlay */#define DDCKEYCAPS_NOCOSTOVERLAY 0x00040000l
/****************************************************************************
* * DIRECTDRAW PIXELFORMAT FLAGS * ****************************************************************************/
/*
* The surface has alpha channel information in the pixel format. */#define DDPF_ALPHAPIXELS 0x00000001l
/*
* The pixel format contains alpha only information */#define DDPF_ALPHA 0x00000002l
/*
* The FourCC code is valid. */#define DDPF_FOURCC 0x00000004l
/*
* The surface is 4-bit color indexed. */#define DDPF_PALETTEINDEXED4 0x00000008l
/*
* The surface is indexed into a palette which stores indices * into the destination surface's 8-bit palette. */#define DDPF_PALETTEINDEXEDTO8 0x00000010l
/*
* The surface is 8-bit color indexed. */#define DDPF_PALETTEINDEXED8 0x00000020l
/*
* The RGB data in the pixel format structure is valid. */#define DDPF_RGB 0x00000040l
/*
* The surface will accept pixel data in the format specified * and compress it during the write. */#define DDPF_COMPRESSED 0x00000080l
/*
* The surface will accept RGB data and translate it during * the write to YUV data. The format of the data to be written * will be contained in the pixel format structure. The DDPF_RGB * flag will be set. */#define DDPF_RGBTOYUV 0x00000100l
/*
* pixel format is YUV - YUV data in pixel format struct is valid */#define DDPF_YUV 0x00000200l
/*
* pixel format is a z buffer only surface */#define DDPF_ZBUFFER 0x00000400l
/*
* The surface is 1-bit color indexed. */#define DDPF_PALETTEINDEXED1 0x00000800l
/*
* The surface is 2-bit color indexed. */#define DDPF_PALETTEINDEXED2 0x00001000l
/*===========================================================================
* * * DIRECTDRAW CALLBACK FLAGS * * *==========================================================================*/
/****************************************************************************
* * DIRECTDRAW ENUMSURFACES FLAGS * ****************************************************************************/
/*
* Enumerate all of the surfaces that meet the search criterion. */#define DDENUMSURFACES_ALL 0x00000001l
/*
* A search hit is a surface that matches the surface description. */#define DDENUMSURFACES_MATCH 0x00000002l
/*
* A search hit is a surface that does not match the surface description. */#define DDENUMSURFACES_NOMATCH 0x00000004l
/*
* Enumerate the first surface that can be created which meets the search criterion. */#define DDENUMSURFACES_CANBECREATED 0x00000008l
/*
* Enumerate the surfaces that already exist that meet the search criterion. */#define DDENUMSURFACES_DOESEXIST 0x00000010l
//@@BEGIN_MSINTERNAL
#define DDENUMSURFACES_VALID 0x0000001fl
//@@END_MSINTERNAL
/****************************************************************************
* * DIRECTDRAW ENUMDISPLAYMODES FLAGS * ****************************************************************************/
/*
* Enumerate Modes with different refresh rates. EnumDisplayModes guarantees * that a particular mode will be enumerated only once. This flag specifies whether * the refresh rate is taken into account when determining if a mode is unique. */#define DDEDM_REFRESHRATES 0x00000001l
//@@BEGIN_MSINTERNAL
#define DDEDM_VALID 0x00000001l
//@@END_MSINTERNAL
/****************************************************************************
* * DIRECTDRAW SETCOOPERATIVELEVEL FLAGS * ****************************************************************************/
/*
* Exclusive mode owner will be responsible for the entire primary surface. * GDI can be ignored. used with DD */#define DDSCL_FULLSCREEN 0x00000001l
/*
* allow CTRL_ALT_DEL to work while in fullscreen exclusive mode */#define DDSCL_ALLOWREBOOT 0x00000002l
/*
* prevents DDRAW from modifying the application window. * prevents DDRAW from minimize/restore the application window on activation. */#define DDSCL_NOWINDOWCHANGES 0x00000004l
/*
* app wants to work as a regular Windows application */#define DDSCL_NORMAL 0x00000008l
/*
* app wants exclusive access */#define DDSCL_EXCLUSIVE 0x00000010l
//@@BEGIN_MSINTERNAL
/*
* dont hook window proc, only valid for non-exclusive */#define DDSCL_DONTHOOKHWND 0x00000020l
//@@END_MSINTERNAL
/*
* app can deal with non-windows display modes */#define DDSCL_ALLOWMODEX 0x00000040l
//@@BEGIN_MSINTERNAL
#define DDSCL_VALID 0x0000007Fl
//@@END_MSINTERNAL
/****************************************************************************
* * DIRECTDRAW BLT FLAGS * ****************************************************************************/
/*
* Use the alpha information in the pixel format or the alpha channel surface * attached to the destination surface as the alpha channel for this blt. */#define DDBLT_ALPHADEST 0x00000001l
/*
* Use the dwConstAlphaDest field in the DDBLTFX structure as the alpha channel * for the destination surface for this blt. */#define DDBLT_ALPHADESTCONSTOVERRIDE 0x00000002l
/*
* The NEG suffix indicates that the destination surface becomes more * transparent as the alpha value increases. (0 is opaque) */#define DDBLT_ALPHADESTNEG 0x00000004l
/*
* Use the lpDDSAlphaDest field in the DDBLTFX structure as the alpha * channel for the destination for this blt. */#define DDBLT_ALPHADESTSURFACEOVERRIDE 0x00000008l
/*
* Use the dwAlphaEdgeBlend field in the DDBLTFX structure as the alpha channel * for the edges of the image that border the color key colors. */#define DDBLT_ALPHAEDGEBLEND 0x00000010l
/*
* Use the alpha information in the pixel format or the alpha channel surface * attached to the source surface as the alpha channel for this blt. */#define DDBLT_ALPHASRC 0x00000020l
/*
* Use the dwConstAlphaSrc field in the DDBLTFX structure as the alpha channel * for the source for this blt. */#define DDBLT_ALPHASRCCONSTOVERRIDE 0x00000040l
/*
* The NEG suffix indicates that the source surface becomes more transparent * as the alpha value increases. (0 is opaque) */#define DDBLT_ALPHASRCNEG 0x00000080l
/*
* Use the lpDDSAlphaSrc field in the DDBLTFX structure as the alpha channel * for the source for this blt. */#define DDBLT_ALPHASRCSURFACEOVERRIDE 0x00000100l
/*
* Do this blt asynchronously through the FIFO in the order received. If * there is no room in the hardware FIFO fail the call. */#define DDBLT_ASYNC 0x00000200l
/*
* Uses the dwFillColor field in the DDBLTFX structure as the RGB color * to fill the destination rectangle on the destination surface with. */#define DDBLT_COLORFILL 0x00000400l
/*
* Uses the dwDDFX field in the DDBLTFX structure to specify the effects * to use for the blt. */#define DDBLT_DDFX 0x00000800l
/*
* Uses the dwDDROPS field in the DDBLTFX structure to specify the ROPS * that are not part of the Win32 API. */#define DDBLT_DDROPS 0x00001000l
/*
* Use the color key associated with the destination surface. */#define DDBLT_KEYDEST 0x00002000l
/*
* Use the dckDestColorkey field in the DDBLTFX structure as the color key * for the destination surface. */#define DDBLT_KEYDESTOVERRIDE 0x00004000l
/*
* Use the color key associated with the source surface. */#define DDBLT_KEYSRC 0x00008000l
/*
* Use the dckSrcColorkey field in the DDBLTFX structure as the color key * for the source surface. */#define DDBLT_KEYSRCOVERRIDE 0x00010000l
/*
* Use the dwROP field in the DDBLTFX structure for the raster operation * for this blt. These ROPs are the same as the ones defined in the Win32 API. */#define DDBLT_ROP 0x00020000l
/*
* Use the dwRotationAngle field in the DDBLTFX structure as the angle * (specified in 1/100th of a degree) to rotate the surface. */#define DDBLT_ROTATIONANGLE 0x00040000l
/*
* Z-buffered blt using the z-buffers attached to the source and destination * surfaces and the dwZBufferOpCode field in the DDBLTFX structure as the * z-buffer opcode. */#define DDBLT_ZBUFFER 0x00080000l
/*
* Z-buffered blt using the dwConstDest Zfield and the dwZBufferOpCode field * in the DDBLTFX structure as the z-buffer and z-buffer opcode respectively * for the destination. */#define DDBLT_ZBUFFERDESTCONSTOVERRIDE 0x00100000l
/*
* Z-buffered blt using the lpDDSDestZBuffer field and the dwZBufferOpCode * field in the DDBLTFX structure as the z-buffer and z-buffer opcode * respectively for the destination. */#define DDBLT_ZBUFFERDESTOVERRIDE 0x00200000l
/*
* Z-buffered blt using the dwConstSrcZ field and the dwZBufferOpCode field * in the DDBLTFX structure as the z-buffer and z-buffer opcode respectively * for the source. */#define DDBLT_ZBUFFERSRCCONSTOVERRIDE 0x00400000l
/*
* Z-buffered blt using the lpDDSSrcZBuffer field and the dwZBufferOpCode * field in the DDBLTFX structure as the z-buffer and z-buffer opcode * respectively for the source. */#define DDBLT_ZBUFFERSRCOVERRIDE 0x00800000l
/*
* wait until the device is ready to handle the blt * this will cause blt to not return DDERR_WASSTILLDRAWING */#define DDBLT_WAIT 0x01000000l
/*
* Uses the dwFillDepth field in the DDBLTFX structure as the depth value * to fill the destination rectangle on the destination Z-buffer surface * with. */#define DDBLT_DEPTHFILL 0x02000000l
//@@BEGIN_MSINTERNAL
#define DDBLT_VALID 0x03ffffffl
//@@END_MSINTERNAL
/****************************************************************************
* * BLTFAST FLAGS * ****************************************************************************/
#define DDBLTFAST_NOCOLORKEY 0x00000000
#define DDBLTFAST_SRCCOLORKEY 0x00000001
#define DDBLTFAST_DESTCOLORKEY 0x00000002
#define DDBLTFAST_WAIT 0x00000010
//@@BEGIN_MSINTERNAL
#define DDBLTFAST_COLORKEY_MASK 0x0000000F
#define DDBLTFAST_VALID 0x00000013
//@@END_MSINTERNAL
/****************************************************************************
* * FLIP FLAGS * ****************************************************************************/
#define DDFLIP_WAIT 0x00000001l
//@@BEGIN_MSINTERNAL
#define DDFLIP_VALID 0x00000001l
//@@END_MSINTERNAL
//@@BEGIN_MSINTERNAL
#ifdef COMPOSITION
/****************************************************************************
* * DIRECTDRAW COMP FLAGS * ****************************************************************************/
/*
* Use the alpha information in the pixel format or the alpha channel surface * attached to the destination surface as the alpha channel for this blt. */#define DDCOMP_ALPHADEST 0x00000001l
/*
* Use the dwConstAlphaDest field in the DDCOMPOSEFX structure as the alpha channel * for the destination surface for this blt. */#define DDCOMP_ALPHADESTCONSTOVERRIDE 0x00000002l
/*
* The NEG suffix indicates that the destination surface becomes more * transparent as the alpha value increases. (0 is opaque) */#define DDCOMP_ALPHADESTNEG 0x00000004l
/*
* Use the lpDDSAlphaDest field in the DDCOMPOSEFX structure as the alpha * channel for the destination for this blt. */#define DDCOMP_ALPHADESTSURFACEOVERRIDE 0x00000008l
/*
* Use the dwAlphaEdgeBlend field in the DDCOMPOSEFX structure as the alpha channel * for the edges of the image that border the color key colors. */#define DDCOMP_ALPHAEDGEBLEND 0x00000010l
/*
* Use the alpha information in the pixel format or the alpha channel surface * attached to the source surface as the alpha channel for this blt. */#define DDCOMP_ALPHASRC 0x00000020l
/*
* Use the dwConstAlphaSrc field in the DDCOMPOSEFX structure as the alpha channel * for the source for this blt. */#define DDCOMP_ALPHASRCCONSTOVERRIDE 0x00000040l
/*
* The NEG suffix indicates that the source surface becomes more transparent * as the alpha value increases. (0 is opaque) */#define DDCOMP_ALPHASRCNEG 0x00000080l
/*
* Use the lpDDSAlphaSrc field in the DDCOMPOSEFX structure as the alpha channel * for the source for this blt. */#define DDCOMP_ALPHASRCSURFACEOVERRIDE 0x00000100l
/*
* Before performing this blt invoke the callback specified by the lpfnCallback * field in the DDCOMPOSEFX structure. */#define DDCOMP_CALLBACK 0x00000200l
/*
* Uses the dwFillColor field in the DDCOMPOSEFX structure as the RGB color * to fill the destination rectangle on the destination surface with. */#define DDCOMP_COLORFILL 0x00000400l
/*
* Uses the dwDDFX field in the DDCOMPOSEFX structure to specify the effects * to use for the blt. */#define DDCOMP_DDFX 0x00000800l
/*
* Uses the dwDDROPS field in the DDCOMPOSEFX structure to specify the ROPS * that are not part of the Win32 API. */#define DDCOMP_DDROPS 0x00001000l
/*
* Use the color key associated with the destination surface. */#define DDCOMP_KEYDEST 0x00002000l
/*
* Use the dckDestColorkey field in the DDCOMPOSEFX structure as the color key * for the destination surface. */#define DDCOMP_KEYDESTOVERRIDE 0x00004000l
/*
* Use the color key associated with the source surface. */#define DDCOMP_KEYSRC 0x00008000l
/*
* Use the dckSrcColorkey field in the DDCOMPOSEFX structure as the color key * for the source surface. */#define DDCOMP_KEYSRCOVERRIDE 0x00010000l
/*
* Do this blt when DestUnlock is called for the last time on the source surface. */#define DDCOMP_ONDESTUNLOCK 0x00020000l
/*
* Do this blt when Flip is called on the source surface. */#define DDCOMP_ONFLIP 0x00040000l
/*
* Do this blt when Unlock is called for the last time on the source surface. */#define DDCOMP_ONUNLOCK 0x00080000l
/*
* Repeat this composition blt the number of times specified in the dwRepeat * field of the DDCOMPOSEFX structure */#define DDCOMP_REPEAT 0x00100000l
/*
* Use the dwROP field in the DDCOMPOSEFX structure for the raster operation * for this blt. These ROPs are the same as the ones defined in the Win32 API. */#define DDCOMP_ROP 0x00200000l
/*
* Use the dwRotationAngle field in the DDCOMPOSEFX structure as the angle * (specified in 1/100th of a degree) to rotate the surface. */#define DDCOMP_ROTATIONANGLE 0x00400000l
/*
* Z-buffered blt using the z-buffers attached to the source and destination * surfaces and the dwZBufferOpCode field in the DDBLTFX structure as the * z-buffer opcode. */#define DDCOMP_ZBUFFER 0x00800000l
/*
* Z-buffered blt using the dwConstDest Zfield and the dwZBufferOpCode field * in the DDCOMPOSEFX structure as the z-buffer and z-buffer opcode respectively * for the destination. */#define DDCOMP_ZBUFFERDESTCONSTOVERRIDE 0x01000000l
/*
* Z-buffered blt using the lpDDSDestZBuffer field and the dwZBufferOpCode * field in the DDCOMPOSEFX structure as the z-buffer and z-buffer opcode * respectively for the destination. */#define DDCOMP_ZBUFFERDESTOVERRIDE 0x02000000l
/*
* Z-buffered blt using the dwConstSrcZ field and the dwZBufferOpCode field * in the DDCOMPOSEFX structure as the z-buffer and z-buffer opcode respectively * for the source. */#define DDCOMP_ZBUFFERSRCCONSTOVERRIDE 0x04000000l
/*
* Z-buffered blt using the lpDDSSrcZBuffer field and the dwZBufferOpCode * field in the DDCOMPOSEFX structure as the z-buffer and z-buffer opcode * respectively for the source. */#define DDCOMP_ZBUFFERSRCOVERRIDE 0x08000000l
#endif
//@@END_MSINTERNAL
/****************************************************************************
* * DIRECTDRAW SURFACE OVERLAY FLAGS * ****************************************************************************/
/*
* Use the alpha information in the pixel format or the alpha channel surface * attached to the destination surface as the alpha channel for the * destination overlay. */#define DDOVER_ALPHADEST 0x00000001l
/*
* Use the dwConstAlphaDest field in the DDOVERLAYFX structure as the * destination alpha channel for this overlay. */#define DDOVER_ALPHADESTCONSTOVERRIDE 0x00000002l
/*
* The NEG suffix indicates that the destination surface becomes more * transparent as the alpha value increases. */#define DDOVER_ALPHADESTNEG 0x00000004l
/*
* Use the lpDDSAlphaDest field in the DDOVERLAYFX structure as the alpha * channel destination for this overlay. */#define DDOVER_ALPHADESTSURFACEOVERRIDE 0x00000008l
/*
* Use the dwAlphaEdgeBlend field in the DDOVERLAYFX structure as the alpha * channel for the edges of the image that border the color key colors. */#define DDOVER_ALPHAEDGEBLEND 0x00000010l
/*
* Use the alpha information in the pixel format or the alpha channel surface * attached to the source surface as the source alpha channel for this overlay. */#define DDOVER_ALPHASRC 0x00000020l
/*
* Use the dwConstAlphaSrc field in the DDOVERLAYFX structure as the source * alpha channel for this overlay. */#define DDOVER_ALPHASRCCONSTOVERRIDE 0x00000040l
/*
* The NEG suffix indicates that the source surface becomes more transparent * as the alpha value increases. */#define DDOVER_ALPHASRCNEG 0x00000080l
/*
* Use the lpDDSAlphaSrc field in the DDOVERLAYFX structure as the alpha channel * source for this overlay. */#define DDOVER_ALPHASRCSURFACEOVERRIDE 0x00000100l
/*
* Turn this overlay off. */#define DDOVER_HIDE 0x00000200l
/*
* Use the color key associated with the destination surface. */#define DDOVER_KEYDEST 0x00000400l
/*
* Use the dckDestColorkey field in the DDOVERLAYFX structure as the color key * for the destination surface */#define DDOVER_KEYDESTOVERRIDE 0x00000800l
/*
* Use the color key associated with the source surface. */#define DDOVER_KEYSRC 0x00001000l
/*
* Use the dckSrcColorkey field in the DDOVERLAYFX structure as the color key * for the source surface. */#define DDOVER_KEYSRCOVERRIDE 0x00002000l
/*
* Turn this overlay on. */#define DDOVER_SHOW 0x00004000l
/*
* Add a dirty rect to an emulated overlayed surface. */#define DDOVER_ADDDIRTYRECT 0x00008000l
/*
* Redraw all dirty rects on an emulated overlayed surface. */#define DDOVER_REFRESHDIRTYRECTS 0x00010000l
/*
* Redraw the entire surface on an emulated overlayed surface. */#define DDOVER_REFRESHALL 0x00020000l
//@@BEGIN_MSINTERNAL
/*
* Force redrawing onto the destination surface without regard for the background */#define DDOVER_REFRESHPOUND 0x00040000l
//@@END_MSINTERNAL
/*
* Use the overlay FX flags to define special overlay FX */#define DDOVER_DDFX 0x00080000l
//@@BEGIN_MSINTERNAL
#define DDOVER_VALID 0x000fffffl
//@@END_MSINTERNAL
/****************************************************************************
* * DIRECTDRAWSURFACE LOCK FLAGS * ****************************************************************************/
/*
* The default. Set to indicate that Lock should return a valid memory pointer * to the top of the specified rectangle. If no rectangle is specified then a * pointer to the top of the surface is returned. */#define DDLOCK_SURFACEMEMORYPTR 0x00000000L // default
/*
* Set to indicate that Lock should wait until it can obtain a valid memory * pointer before returning. If this bit is set, Lock will never return * DDERR_WASSTILLDRAWING. */#define DDLOCK_WAIT 0x00000001L
/*
* Set if an event handle is being passed to Lock. Lock will trigger the event * when it can return the surface memory pointer requested. */#define DDLOCK_EVENT 0x00000002L
/*
* Indicates that the surface being locked will only be read from. */#define DDLOCK_READONLY 0x00000010L
/*
* Indicates that the surface being locked will only be written to */#define DDLOCK_WRITEONLY 0x00000020L
//@@BEGIN_MSINTERNAL
/*
* Indicates that InternalLock should set the busy bit and Win16 lock * for surfaces not explicitly in system memory. */#define DDLOCK_TAKE_WIN16 0x00000040L
/*
* Indicates that InternalLock should set the busy bit and Win16 lock * for surfaces in video memory only */#define DDLOCK_TAKE_WIN16_VRAM 0x00000080L
/*
* Indicates that InternalLock should check for lost surfaces. By * default it does not. */#define DDLOCK_FAILLOSTSURFACES 0x00000100L
/*
* An aggregate of all the valid flags */#define DDLOCK_VALID 0x00000031L
//@@END_MSINTERNAL
/****************************************************************************
* * DIRECTDRAWSURFACE PAGELOCK FLAGS * ****************************************************************************/
/*
* No flags defined at present */
//@@BEGIN_MSINTERNAL
#define DDPAGELOCK_VALID 0x00000000L
//@@END_MSINTERNAL
/****************************************************************************
* * DIRECTDRAWSURFACE PAGEUNLOCK FLAGS * ****************************************************************************/
/*
* No flags defined at present */
//@@BEGIN_MSINTERNAL
#define DDPAGEUNLOCK_VALID 0x00000000L
//@@END_MSINTERNAL
/****************************************************************************
* * DIRECTDRAWSURFACE BLT FX FLAGS * ****************************************************************************/
/*
* If stretching, use arithmetic stretching along the Y axis for this blt. */#define DDBLTFX_ARITHSTRETCHY 0x00000001l
/*
* Do this blt mirroring the surface left to right. Spin the * surface around its y-axis. */#define DDBLTFX_MIRRORLEFTRIGHT 0x00000002l
/*
* Do this blt mirroring the surface up and down. Spin the surface * around its x-axis. */#define DDBLTFX_MIRRORUPDOWN 0x00000004l
/*
* Schedule this blt to avoid tearing. */#define DDBLTFX_NOTEARING 0x00000008l
/*
* Do this blt rotating the surface one hundred and eighty degrees. */#define DDBLTFX_ROTATE180 0x00000010l
/*
* Do this blt rotating the surface two hundred and seventy degrees. */#define DDBLTFX_ROTATE270 0x00000020l
/*
* Do this blt rotating the surface ninety degrees. */#define DDBLTFX_ROTATE90 0x00000040l
/*
* Do this z blt using dwZBufferLow and dwZBufferHigh as range values * specified to limit the bits copied from the source surface. */#define DDBLTFX_ZBUFFERRANGE 0x00000080l
/*
* Do this z blt adding the dwZBufferBaseDest to each of the sources z values * before comparing it with the desting z values. */#define DDBLTFX_ZBUFFERBASEDEST 0x00000100l
//@@BEGIN_MSINTERNAL
/****************************************************************************
* * DIRECTDRAWSURFACE COMP FX FLAGS * ****************************************************************************/
/*
* If stretching, use arithmetic stretching along the Y axis for this blt. */#define DDCOMPFX_ARITHSTRETCHY 0x00000001l
/*
* Do this blt mirroring the surface left to right. Spin the * surface around its y-axis. */#define DDCOMPFX_MIRRORLEFTRIGHT 0x00000002l
/*
* Do this blt mirroring the surface up and down. Spin the surface * around its x-axis. */#define DDCOMPFX_MIRRORUPDOWN 0x00000004l
/*
* Schedule this blt to avoid tearing. */#define DDCOMPFX_NOTEARING 0x00000008l
/*
* Do this blt rotating the surface one hundred and eighty degrees. */#define DDCOMPFX_ROTATE180 0x00000010l
/*
* Do this blt rotating the surface two hundred and seventy degrees. */#define DDCOMPFX_ROTATE270 0x00000020l
/*
* Do this blt rotating the surface ninety degrees. */#define DDCOMPFX_ROTATE90 0x00000040l
/*
* Do this z blt using dwZBufferLow and dwZBufferHigh as range values * specified to limit the bits copied from the source surface. */#define DDCOMPFX_ZBUFFERRANGE 0x00000080l
/*
* Do this z blt adding the dwZBufferBaseDest to each of the sources z values * before comparing it with the desting z values. */#define DDCOMPFX_ZBUFFERBASEDEST 0x00000100l
//@@END_MSINTERNAL
/****************************************************************************
* * DIRECTDRAWSURFACE OVERLAY FX FLAGS * ****************************************************************************/
/*
* If stretching, use arithmetic stretching along the Y axis for this overlay. */#define DDOVERFX_ARITHSTRETCHY 0x00000001l
/*
* Mirror the overlay across the vertical axis */#define DDOVERFX_MIRRORLEFTRIGHT 0x00000002l
/*
* Mirror the overlay across the horizontal axis */#define DDOVERFX_MIRRORUPDOWN 0x00000004l
/****************************************************************************
* * DIRECTDRAW WAITFORVERTICALBLANK FLAGS * ****************************************************************************/
/*
* return when the vertical blank interval begins */#define DDWAITVB_BLOCKBEGIN 0x00000001l
/*
* set up an event to trigger when the vertical blank begins */#define DDWAITVB_BLOCKBEGINEVENT 0x00000002l
/*
* return when the vertical blank interval ends and display begins */#define DDWAITVB_BLOCKEND 0x00000004l
/****************************************************************************
* * DIRECTDRAW GETFLIPSTATUS FLAGS * ****************************************************************************/
/*
* is it OK to flip now? */#define DDGFS_CANFLIP 0x00000001l
/*
* is the last flip finished? */#define DDGFS_ISFLIPDONE 0x00000002l
// @@BEGIN_MSINTERNAL
#define DDGFS_VALID 0x00000003l
// @@END_MSINTERNAL
/****************************************************************************
* * DIRECTDRAW GETBLTSTATUS FLAGS * ****************************************************************************/
/*
* is it OK to blt now? */#define DDGBS_CANBLT 0x00000001l
/*
* is the blt to the surface finished? */#define DDGBS_ISBLTDONE 0x00000002l
// @@BEGIN_MSINTERNAL
#define DDGBS_VALID 0x00000003l
// @@END_MSINTERNAL
/****************************************************************************
* * DIRECTDRAW ENUMOVERLAYZORDER FLAGS * ****************************************************************************/
/*
* Enumerate overlays back to front. */#define DDENUMOVERLAYZ_BACKTOFRONT 0x00000000l
/*
* Enumerate overlays front to back */#define DDENUMOVERLAYZ_FRONTTOBACK 0x00000001l
/****************************************************************************
* * DIRECTDRAW UPDATEOVERLAYZORDER FLAGS * ****************************************************************************/
/*
* Send overlay to front */#define DDOVERZ_SENDTOFRONT 0x00000000l
/*
* Send overlay to back */#define DDOVERZ_SENDTOBACK 0x00000001l
/*
* Move Overlay forward */#define DDOVERZ_MOVEFORWARD 0x00000002l
/*
* Move Overlay backward */#define DDOVERZ_MOVEBACKWARD 0x00000003l
/*
* Move Overlay in front of relative surface */#define DDOVERZ_INSERTINFRONTOF 0x00000004l
/*
* Move Overlay in back of relative surface */#define DDOVERZ_INSERTINBACKOF 0x00000005l
/*===========================================================================
* * * DIRECTDRAW RETURN CODES * * The return values from DirectDraw Commands and Surface that return an HRESULT * are codes from DirectDraw concerning the results of the action * requested by DirectDraw. * *==========================================================================*/
/*
* Status is OK * * Issued by: DirectDraw Commands and all callbacks *///@@BEGIN_MSINTERNAL
#define DD_OK_HANDLED 1
#define DD_OK_NOTHANDLED 0
//@@END_MSINTERNAL
#define DD_OK 0
/****************************************************************************
* * DIRECTDRAW ENUMCALLBACK RETURN VALUES * * EnumCallback returns are used to control the flow of the DIRECTDRAW and * DIRECTDRAWSURFACE object enumerations. They can only be returned by * enumeration callback routines. * ****************************************************************************/
/*
* stop the enumeration */#define DDENUMRET_CANCEL 0
/*
* continue the enumeration */#define DDENUMRET_OK 1
/****************************************************************************
* * DIRECTDRAW ERRORS * * Errors are represented by negative values and cannot be combined. * ****************************************************************************/
/*
* This object is already initialized */#define DDERR_ALREADYINITIALIZED MAKE_DDHRESULT( 5 )
/*
* This surface can not be attached to the requested surface. */#define DDERR_CANNOTATTACHSURFACE MAKE_DDHRESULT( 10 )
/*
* This surface can not be detached from the requested surface. */#define DDERR_CANNOTDETACHSURFACE MAKE_DDHRESULT( 20 )
/*
* Support is currently not available. */#define DDERR_CURRENTLYNOTAVAIL MAKE_DDHRESULT( 40 )
/*
* An exception was encountered while performing the requested operation */#define DDERR_EXCEPTION MAKE_DDHRESULT( 55 )
/*
* Generic failure. */#define DDERR_GENERIC E_FAIL
/*
* Height of rectangle provided is not a multiple of reqd alignment */#define DDERR_HEIGHTALIGN MAKE_DDHRESULT( 90 )
/*
* Unable to match primary surface creation request with existing * primary surface. */#define DDERR_INCOMPATIBLEPRIMARY MAKE_DDHRESULT( 95 )
/*
* One or more of the caps bits passed to the callback are incorrect. */#define DDERR_INVALIDCAPS MAKE_DDHRESULT( 100 )
/*
* DirectDraw does not support provided Cliplist. */#define DDERR_INVALIDCLIPLIST MAKE_DDHRESULT( 110 )
/*
* DirectDraw does not support the requested mode */#define DDERR_INVALIDMODE MAKE_DDHRESULT( 120 )
/*
* DirectDraw received a pointer that was an invalid DIRECTDRAW object. */#define DDERR_INVALIDOBJECT MAKE_DDHRESULT( 130 )
/*
* One or more of the parameters passed to the callback function are * incorrect. */#define DDERR_INVALIDPARAMS E_INVALIDARG
/*
* pixel format was invalid as specified */#define DDERR_INVALIDPIXELFORMAT MAKE_DDHRESULT( 145 )
/*
* Rectangle provided was invalid. */#define DDERR_INVALIDRECT MAKE_DDHRESULT( 150 )
/*
* Operation could not be carried out because one or more surfaces are locked */#define DDERR_LOCKEDSURFACES MAKE_DDHRESULT( 160 )
/*
* There is no 3D present. */#define DDERR_NO3D MAKE_DDHRESULT( 170 )
/*
* Operation could not be carried out because there is no alpha accleration * hardware present or available. */#define DDERR_NOALPHAHW MAKE_DDHRESULT( 180 )
// @@BEGIN_MSINTERNAL
/*
* Operation could not be carried out because there is no hardware support * for synchronizing blts to avoid tearing. */#define DDERR_NOANTITEARHW MAKE_DDHRESULT( 190 )
/*
* Operation could not be carried out because there is no hardware support * for asynchronous blting. */#define DDERR_NOBLTQUEUEHW MAKE_DDHRESULT( 200 )
// @@END_MSINTERNAL
/*
* no clip list available */#define DDERR_NOCLIPLIST MAKE_DDHRESULT( 205 )
/*
* Operation could not be carried out because there is no color conversion * hardware present or available. */#define DDERR_NOCOLORCONVHW MAKE_DDHRESULT( 210 )
/*
* Create function called without DirectDraw object method SetCooperativeLevel * being called. */#define DDERR_NOCOOPERATIVELEVELSET MAKE_DDHRESULT( 212 )
/*
* Surface doesn't currently have a color key */#define DDERR_NOCOLORKEY MAKE_DDHRESULT( 215 )
/*
* Operation could not be carried out because there is no hardware support * of the dest color key. */#define DDERR_NOCOLORKEYHW MAKE_DDHRESULT( 220 )
/*
* No DirectDraw support possible with current display driver */#define DDERR_NODIRECTDRAWSUPPORT MAKE_DDHRESULT( 222 )
/*
* Operation requires the application to have exclusive mode but the * application does not have exclusive mode. */#define DDERR_NOEXCLUSIVEMODE MAKE_DDHRESULT( 225 )
/*
* Flipping visible surfaces is not supported. */#define DDERR_NOFLIPHW MAKE_DDHRESULT( 230 )
/*
* There is no GDI present. */#define DDERR_NOGDI MAKE_DDHRESULT( 240 )
/*
* Operation could not be carried out because there is no hardware present * or available. */#define DDERR_NOMIRRORHW MAKE_DDHRESULT( 250 )
/*
* Requested item was not found */#define DDERR_NOTFOUND MAKE_DDHRESULT( 255 )
/*
* Operation could not be carried out because there is no overlay hardware * present or available. */#define DDERR_NOOVERLAYHW MAKE_DDHRESULT( 260 )
/*
* Operation could not be carried out because there is no appropriate raster * op hardware present or available. */#define DDERR_NORASTEROPHW MAKE_DDHRESULT( 280 )
/*
* Operation could not be carried out because there is no rotation hardware * present or available. */#define DDERR_NOROTATIONHW MAKE_DDHRESULT( 290 )
/*
* Operation could not be carried out because there is no hardware support * for stretching */#define DDERR_NOSTRETCHHW MAKE_DDHRESULT( 310 )
/*
* DirectDrawSurface is not in 4 bit color palette and the requested operation * requires 4 bit color palette. */#define DDERR_NOT4BITCOLOR MAKE_DDHRESULT( 316 )
/*
* DirectDrawSurface is not in 4 bit color index palette and the requested * operation requires 4 bit color index palette. */#define DDERR_NOT4BITCOLORINDEX MAKE_DDHRESULT( 317 )
/*
* DirectDraw Surface is not in 8 bit color mode and the requested operation * requires 8 bit color. */#define DDERR_NOT8BITCOLOR MAKE_DDHRESULT( 320 )
/*
* Operation could not be carried out because there is no texture mapping * hardware present or available. */#define DDERR_NOTEXTUREHW MAKE_DDHRESULT( 330 )
/*
* Operation could not be carried out because there is no hardware support * for vertical blank synchronized operations. */#define DDERR_NOVSYNCHW MAKE_DDHRESULT( 335 )
/*
* Operation could not be carried out because there is no hardware support * for zbuffer blting. */#define DDERR_NOZBUFFERHW MAKE_DDHRESULT( 340 )
/*
* Overlay surfaces could not be z layered based on their BltOrder because * the hardware does not support z layering of overlays. */#define DDERR_NOZOVERLAYHW MAKE_DDHRESULT( 350 )
/*
* The hardware needed for the requested operation has already been * allocated. */#define DDERR_OUTOFCAPS MAKE_DDHRESULT( 360 )
/*
* DirectDraw does not have enough memory to perform the operation. */#define DDERR_OUTOFMEMORY E_OUTOFMEMORY
/*
* DirectDraw does not have enough memory to perform the operation. */#define DDERR_OUTOFVIDEOMEMORY MAKE_DDHRESULT( 380 )
/*
* hardware does not support clipped overlays */#define DDERR_OVERLAYCANTCLIP MAKE_DDHRESULT( 382 )
/*
* Can only have ony color key active at one time for overlays */#define DDERR_OVERLAYCOLORKEYONLYONEACTIVE MAKE_DDHRESULT( 384 )
/*
* Access to this palette is being refused because the palette is already * locked by another thread. */#define DDERR_PALETTEBUSY MAKE_DDHRESULT( 387 )
/*
* No src color key specified for this operation. */#define DDERR_COLORKEYNOTSET MAKE_DDHRESULT( 400 )
/*
* This surface is already attached to the surface it is being attached to. */#define DDERR_SURFACEALREADYATTACHED MAKE_DDHRESULT( 410 )
/*
* This surface is already a dependency of the surface it is being made a * dependency of. */#define DDERR_SURFACEALREADYDEPENDENT MAKE_DDHRESULT( 420 )
/*
* Access to this surface is being refused because the surface is already * locked by another thread. */#define DDERR_SURFACEBUSY MAKE_DDHRESULT( 430 )
/*
* Access to this surface is being refused because no driver exists * which can supply a pointer to the surface. * This is most likely to happen when attempting to lock the primary * surface when no DCI provider is present. */#define DDERR_CANTLOCKSURFACE MAKE_DDHRESULT( 435 )
/*
* Access to Surface refused because Surface is obscured. */#define DDERR_SURFACEISOBSCURED MAKE_DDHRESULT( 440 )
/*
* Access to this surface is being refused because the surface is gone. * The DIRECTDRAWSURFACE object representing this surface should * have Restore called on it. */#define DDERR_SURFACELOST MAKE_DDHRESULT( 450 )
/*
* The requested surface is not attached. */#define DDERR_SURFACENOTATTACHED MAKE_DDHRESULT( 460 )
/*
* Height requested by DirectDraw is too large. */#define DDERR_TOOBIGHEIGHT MAKE_DDHRESULT( 470 )
/*
* Size requested by DirectDraw is too large -- The individual height and * width are OK. */#define DDERR_TOOBIGSIZE MAKE_DDHRESULT( 480 )
/*
* Width requested by DirectDraw is too large. */#define DDERR_TOOBIGWIDTH MAKE_DDHRESULT( 490 )
/*
* Action not supported. */#define DDERR_UNSUPPORTED E_NOTIMPL
/*
* FOURCC format requested is unsupported by DirectDraw */#define DDERR_UNSUPPORTEDFORMAT MAKE_DDHRESULT( 510 )
/*
* Bitmask in the pixel format requested is unsupported by DirectDraw */#define DDERR_UNSUPPORTEDMASK MAKE_DDHRESULT( 520 )
/*
* vertical blank is in progress */#define DDERR_VERTICALBLANKINPROGRESS MAKE_DDHRESULT( 537 )
/*
* Informs DirectDraw that the previous Blt which is transfering information * to or from this Surface is incomplete. */#define DDERR_WASSTILLDRAWING MAKE_DDHRESULT( 540 )
/*
* Rectangle provided was not horizontally aligned on reqd. boundary */#define DDERR_XALIGN MAKE_DDHRESULT( 560 )
/*
* The GUID passed to DirectDrawCreate is not a valid DirectDraw driver * identifier. */#define DDERR_INVALIDDIRECTDRAWGUID MAKE_DDHRESULT( 561 )
/*
* A DirectDraw object representing this driver has already been created * for this process. */#define DDERR_DIRECTDRAWALREADYCREATED MAKE_DDHRESULT( 562 )
/*
* A hardware only DirectDraw object creation was attempted but the driver * did not support any hardware. */#define DDERR_NODIRECTDRAWHW MAKE_DDHRESULT( 563 )
/*
* this process already has created a primary surface */#define DDERR_PRIMARYSURFACEALREADYEXISTS MAKE_DDHRESULT( 564 )
/*
* software emulation not available. */#define DDERR_NOEMULATION MAKE_DDHRESULT( 565 )
/*
* region passed to Clipper::GetClipList is too small. */#define DDERR_REGIONTOOSMALL MAKE_DDHRESULT( 566 )
/*
* an attempt was made to set a clip list for a clipper objec that * is already monitoring an hwnd. */#define DDERR_CLIPPERISUSINGHWND MAKE_DDHRESULT( 567 )
/*
* No clipper object attached to surface object */#define DDERR_NOCLIPPERATTACHED MAKE_DDHRESULT( 568 )
/*
* Clipper notification requires an HWND or * no HWND has previously been set as the CooperativeLevel HWND. */#define DDERR_NOHWND MAKE_DDHRESULT( 569 )
/*
* HWND used by DirectDraw CooperativeLevel has been subclassed, * this prevents DirectDraw from restoring state. */#define DDERR_HWNDSUBCLASSED MAKE_DDHRESULT( 570 )
/*
* The CooperativeLevel HWND has already been set. * It can not be reset while the process has surfaces or palettes created. */#define DDERR_HWNDALREADYSET MAKE_DDHRESULT( 571 )
/*
* No palette object attached to this surface. */#define DDERR_NOPALETTEATTACHED MAKE_DDHRESULT( 572 )
/*
* No hardware support for 16 or 256 color palettes. */#define DDERR_NOPALETTEHW MAKE_DDHRESULT( 573 )
/*
* If a clipper object is attached to the source surface passed into a * BltFast call. */#define DDERR_BLTFASTCANTCLIP MAKE_DDHRESULT( 574 )
/*
* No blter. */#define DDERR_NOBLTHW MAKE_DDHRESULT( 575 )
/*
* No DirectDraw ROP hardware. */#define DDERR_NODDROPSHW MAKE_DDHRESULT( 576 )
/*
* returned when GetOverlayPosition is called on a hidden overlay */#define DDERR_OVERLAYNOTVISIBLE MAKE_DDHRESULT( 577 )
/*
* returned when GetOverlayPosition is called on a overlay that UpdateOverlay * has never been called on to establish a destionation. */#define DDERR_NOOVERLAYDEST MAKE_DDHRESULT( 578 )
/*
* returned when the position of the overlay on the destionation is no longer * legal for that destionation. */#define DDERR_INVALIDPOSITION MAKE_DDHRESULT( 579 )
/*
* returned when an overlay member is called for a non-overlay surface */#define DDERR_NOTAOVERLAYSURFACE MAKE_DDHRESULT( 580 )
/*
* An attempt was made to set the cooperative level when it was already * set to exclusive. */#define DDERR_EXCLUSIVEMODEALREADYSET MAKE_DDHRESULT( 581 )
/*
* An attempt has been made to flip a surface that is not flippable. */#define DDERR_NOTFLIPPABLE MAKE_DDHRESULT( 582 )
/*
* Can't duplicate primary & 3D surfaces, or surfaces that are implicitly * created. */#define DDERR_CANTDUPLICATE MAKE_DDHRESULT( 583 )
/*
* Surface was not locked. An attempt to unlock a surface that was not * locked at all, or by this process, has been attempted. */#define DDERR_NOTLOCKED MAKE_DDHRESULT( 584 )
/*
* Windows can not create any more DCs */#define DDERR_CANTCREATEDC MAKE_DDHRESULT( 585 )
/*
* No DC was ever created for this surface. */#define DDERR_NODC MAKE_DDHRESULT( 586 )
/*
* This surface can not be restored because it was created in a different * mode. */#define DDERR_WRONGMODE MAKE_DDHRESULT( 587 )
/*
* This surface can not be restored because it is an implicitly created * surface. */#define DDERR_IMPLICITLYCREATED MAKE_DDHRESULT( 588 )
/*
* The surface being used is not a palette-based surface */#define DDERR_NOTPALETTIZED MAKE_DDHRESULT( 589 )
/*
* The display is currently in an unsupported mode */#define DDERR_UNSUPPORTEDMODE MAKE_DDHRESULT( 590 )
/*
* Operation could not be carried out because there is no mip-map * texture mapping hardware present or available. */#define DDERR_NOMIPMAPHW MAKE_DDHRESULT( 591 )
/*
* The requested action could not be performed because the surface was of * the wrong type. */#define DDERR_INVALIDSURFACETYPE MAKE_DDHRESULT( 592 )
// @@BEGIN_MSINTERNAL
/*
* Operation could not be carried out because there is no hardware support * for execute buffers. */#define DDERR_NOEXECUTEBUFFERHW MAKE_DDHRESULT( 593 )
// @@END_MSINTERNAL
// @@BEGIN_MSINTERNAL
#ifdef SHAREDZ
/*
* This process has already created a shared Z buffer */#define DDERR_SHAREDZBUFFERALREADYEXISTS MAKE_DDHRESULT( 594 )
/*
* Unable to match shared Z buffer creation request with existing * shared Z buffer. */#define DDERR_INCOMPATIBLESHAREDZBUFFER MAKE_DDHRESULT( 595 )
/*
* This process has already created a shared backbuffer */#define DDERR_SHAREDBACKBUFFERALREADYEXISTS MAKE_DDHRESULT( 596 )
/*
* Unable to match shared backbuffer creation request with existing * shared backbuffer. */#define DDERR_INCOMPATIBLESHAREDBACKBUFFER MAKE_DDHRESULT( 597 )
/*
* Operation could not be carried out because there is no hardware support * for shared Z buffers. */#define DDERR_NOSHAREDZBUFFERHW MAKE_DDHRESULT( 598 )
/*
* Operation could not be carried out because there is no hardware support * for shared backbuffers. */#define DDERR_NOSHAREDBACKBUFFERHW MAKE_DDHRESULT( 599 )
#endif
// @@END_MSINTERNAL
/*
* A DC has already been returned for this surface. Only one DC can be * retrieved per surface. */#define DDERR_DCALREADYCREATED MAKE_DDHRESULT( 620 )
/*
* The attempt to page lock a surface failed. */#define DDERR_CANTPAGELOCK MAKE_DDHRESULT( 640 )
/*
* The attempt to page unlock a surface failed. */#define DDERR_CANTPAGEUNLOCK MAKE_DDHRESULT( 660 )
/*
* An attempt was made to page unlock a surface with no outstanding page locks. */#define DDERR_NOTPAGELOCKED MAKE_DDHRESULT( 680 )
/*
* An attempt was made to invoke an interface member of a DirectDraw object * created by CoCreateInstance() before it was initialized. */#define DDERR_NOTINITIALIZED CO_E_NOTINITIALIZED
/* Alpha bit depth constants */
//@@BEGIN_MSINTERNAL
/*
* 1 bit alpha constants */
/*
* Completely transparent. Colors being blended with this constant do not affect * the final result. */#define DDALPHA1_TRANSPARENT 0
/*
* Completely opaque. Colors being blended with this constant are the final result. */#define DDALPHA1_OPAQUE 1
/*
* 2 bit alpha constants */
/*
* Completely transparent. Colors being blended with this constant do not effect * the final result. */#define DDALPHA2_TRANSPARENT 0
/*
* 50-50 blend. Colors being blended with this constant effect the final result * with 50% of their color. */#define DDALPHA2_50 2
/*
* Completely opaque. Colors being blended with this constant are the final result. */#define DDALPHA2_OPAQUE 3
/*
* 4 bit alpha constants */
/*
* Completely transparent. Colors being blended with this constant do not effect * the final result. */#define DDALPHA4_TRANSPARENT 0
/*
* Opaque modifier is multiplied by any value between 0 and _OPAQUE to * establish gradients of alpha blending. */#define DDALPHA4_OPAQUEMOD 1
/*
* 50-50 blend. Colors being blended with this constant effect the final result * with 50% of their color. */#define DDALPHA4_50 8
/*
* Completely opaque. Colors being blended with this constant are the final result. */#define DDALPHA4_OPAQUE 15
/*
* 8 bit alpha constants */
/*
* Completely transparent. Colors being blended with this constant do not effect * the final result. */#define DDALPHA8_TRANSPARENT 0
/*
* Opaque modifier is multiplied by any value between 0 and _OPAQUE to * establish gradients of alpha blending. */#define DDALPHA8_OPAQUEMOD 1
/*
* 50-50 blend. Colors being blended with this constant effect the final result * with 50% of their color. */#define DDALPHA8_50 128
/*
* Completely opaque. Colors being blended with this constant are the final result. */#define DDALPHA8_OPAQUE 255
//@@END_MSINTERNAL
#ifdef __cplusplus
};#endif
#endif
|
