home *** CD-ROM | disk | FTP | other *** search
/ Beginning Direct3D Game Programming / Direct3D.iso / directx / dxf / include / ddraw.h < prev    next >
C/C++ Source or Header  |  2000-10-20  |  240KB  |  5,669 lines
  1. /*==========================================================================;
  2.  *
  3.  *  Copyright (C) 1994-1997 Microsoft Corporation.  All Rights Reserved.
  4.  *
  5.  *  File:       ddraw.h
  6.  *  Content:    DirectDraw include file
  7.  *
  8.  ***************************************************************************/
  9.  
  10. #ifndef __DDRAW_INCLUDED__
  11. #define __DDRAW_INCLUDED__
  12.  
  13. //Disable the nameless union warning when building internally
  14. #undef ENABLE_NAMELESS_UNION_PRAGMA
  15. #ifdef DIRECTX_REDIST
  16. #define ENABLE_NAMELESS_UNION_PRAGMA
  17. #endif
  18.  
  19. #ifdef ENABLE_NAMELESS_UNION_PRAGMA
  20. #pragma warning(disable:4201)
  21. #endif
  22.  
  23. /*
  24.  * If you wish an application built against the newest version of DirectDraw
  25.  * to run against an older DirectDraw run time then define DIRECTDRAW_VERSION
  26.  * to be the earlies version of DirectDraw you wish to run against. For,
  27.  * example if you wish an application to run against a DX 3 runtime define
  28.  * DIRECTDRAW_VERSION to be 0x0300.
  29.  */
  30. #ifndef   DIRECTDRAW_VERSION
  31. #define   DIRECTDRAW_VERSION 0x0700
  32. #endif /* DIRECTDRAW_VERSION */
  33.  
  34. #if defined( _WIN32 )  && !defined( _NO_COM )
  35. #define COM_NO_WINDOWS_H
  36. #include <objbase.h>
  37. #else
  38. #define IUnknown            void
  39. #if !defined( NT_BUILD_ENVIRONMENT ) && !defined(WINNT)
  40.         #define CO_E_NOTINITIALIZED 0x800401F0L
  41. #endif
  42. #endif
  43.  
  44. #define _FACDD  0x876
  45. #define MAKE_DDHRESULT( code )  MAKE_HRESULT( 1, _FACDD, code )
  46.  
  47. #ifdef __cplusplus
  48. extern "C" {
  49. #endif
  50.  
  51. //
  52. // For compilers that don't support nameless unions, do a
  53. //
  54. // #define NONAMELESSUNION
  55. //
  56. // before #include <ddraw.h>
  57. //
  58. #ifndef DUMMYUNIONNAMEN
  59. #if defined(__cplusplus) || !defined(NONAMELESSUNION)
  60. #define DUMMYUNIONNAMEN(n)
  61. #else
  62. #define DUMMYUNIONNAMEN(n)      u##n
  63. #endif
  64. #endif
  65.  
  66. #ifndef MAKEFOURCC
  67.     #define MAKEFOURCC(ch0, ch1, ch2, ch3)                              \
  68.                 ((DWORD)(BYTE)(ch0) | ((DWORD)(BYTE)(ch1) << 8) |   \
  69.                 ((DWORD)(BYTE)(ch2) << 16) | ((DWORD)(BYTE)(ch3) << 24 ))
  70. #endif //defined(MAKEFOURCC)
  71.  
  72. /*
  73.  * FOURCC codes for DX compressed-texture pixel formats
  74.  */
  75. #define FOURCC_DXT1  (MAKEFOURCC('D','X','T','1'))
  76. #define FOURCC_DXT2  (MAKEFOURCC('D','X','T','2'))
  77. #define FOURCC_DXT3  (MAKEFOURCC('D','X','T','3'))
  78. #define FOURCC_DXT4  (MAKEFOURCC('D','X','T','4'))
  79. #define FOURCC_DXT5  (MAKEFOURCC('D','X','T','5'))
  80.  
  81. /*
  82.  * GUIDS used by DirectDraw objects
  83.  */
  84. #if defined( _WIN32 ) && !defined( _NO_COM )
  85.  
  86. DEFINE_GUID( CLSID_DirectDraw,                  0xD7B70EE0,0x4340,0x11CF,0xB0,0x63,0x00,0x20,0xAF,0xC2,0xCD,0x35 );
  87. DEFINE_GUID( CLSID_DirectDraw7,                 0x3c305196,0x50db,0x11d3,0x9c,0xfe,0x00,0xc0,0x4f,0xd9,0x30,0xc5 );
  88. DEFINE_GUID( CLSID_DirectDrawClipper,           0x593817A0,0x7DB3,0x11CF,0xA2,0xDE,0x00,0xAA,0x00,0xb9,0x33,0x56 );
  89. DEFINE_GUID( IID_IDirectDraw,                   0x6C14DB80,0xA733,0x11CE,0xA5,0x21,0x00,0x20,0xAF,0x0B,0xE5,0x60 );
  90. DEFINE_GUID( IID_IDirectDraw2,                  0xB3A6F3E0,0x2B43,0x11CF,0xA2,0xDE,0x00,0xAA,0x00,0xB9,0x33,0x56 );
  91. DEFINE_GUID( IID_IDirectDraw4,                  0x9c59509a,0x39bd,0x11d1,0x8c,0x4a,0x00,0xc0,0x4f,0xd9,0x30,0xc5 );
  92. DEFINE_GUID( IID_IDirectDraw7,                  0x15e65ec0,0x3b9c,0x11d2,0xb9,0x2f,0x00,0x60,0x97,0x97,0xea,0x5b );
  93. DEFINE_GUID( IID_IDirectDrawSurface,            0x6C14DB81,0xA733,0x11CE,0xA5,0x21,0x00,0x20,0xAF,0x0B,0xE5,0x60 );
  94. DEFINE_GUID( IID_IDirectDrawSurface2,           0x57805885,0x6eec,0x11cf,0x94,0x41,0xa8,0x23,0x03,0xc1,0x0e,0x27 );
  95. DEFINE_GUID( IID_IDirectDrawSurface3,           0xDA044E00,0x69B2,0x11D0,0xA1,0xD5,0x00,0xAA,0x00,0xB8,0xDF,0xBB );
  96. DEFINE_GUID( IID_IDirectDrawSurface4,           0x0B2B8630,0xAD35,0x11D0,0x8E,0xA6,0x00,0x60,0x97,0x97,0xEA,0x5B );
  97. DEFINE_GUID( IID_IDirectDrawSurface7,           0x06675a80,0x3b9b,0x11d2,0xb9,0x2f,0x00,0x60,0x97,0x97,0xea,0x5b );
  98. DEFINE_GUID( IID_IDirectDrawPalette,            0x6C14DB84,0xA733,0x11CE,0xA5,0x21,0x00,0x20,0xAF,0x0B,0xE5,0x60 );
  99. DEFINE_GUID( IID_IDirectDrawClipper,            0x6C14DB85,0xA733,0x11CE,0xA5,0x21,0x00,0x20,0xAF,0x0B,0xE5,0x60 );
  100. DEFINE_GUID( IID_IDirectDrawColorControl,       0x4B9F0EE0,0x0D7E,0x11D0,0x9B,0x06,0x00,0xA0,0xC9,0x03,0xA3,0xB8 );
  101. DEFINE_GUID( IID_IDirectDrawGammaControl,       0x69C11C3E,0xB46B,0x11D1,0xAD,0x7A,0x00,0xC0,0x4F,0xC2,0x9B,0x4E );
  102.  
  103. #endif
  104.  
  105. /*============================================================================
  106.  *
  107.  * DirectDraw Structures
  108.  *
  109.  * Various structures used to invoke DirectDraw.
  110.  *
  111.  *==========================================================================*/
  112.  
  113. struct IDirectDraw;
  114. struct IDirectDrawSurface;
  115. struct IDirectDrawPalette;
  116. struct IDirectDrawClipper;
  117.  
  118. typedef struct IDirectDraw              FAR *LPDIRECTDRAW;
  119. typedef struct IDirectDraw2             FAR *LPDIRECTDRAW2;
  120. typedef struct IDirectDraw4             FAR *LPDIRECTDRAW4;
  121. typedef struct IDirectDraw7             FAR *LPDIRECTDRAW7;
  122. typedef struct IDirectDrawSurface       FAR *LPDIRECTDRAWSURFACE;
  123. typedef struct IDirectDrawSurface2      FAR *LPDIRECTDRAWSURFACE2;
  124. typedef struct IDirectDrawSurface3      FAR *LPDIRECTDRAWSURFACE3;
  125. typedef struct IDirectDrawSurface4      FAR *LPDIRECTDRAWSURFACE4;
  126. typedef struct IDirectDrawSurface7      FAR *LPDIRECTDRAWSURFACE7;
  127. typedef struct IDirectDrawPalette               FAR *LPDIRECTDRAWPALETTE;
  128. typedef struct IDirectDrawClipper               FAR *LPDIRECTDRAWCLIPPER;
  129. typedef struct IDirectDrawColorControl          FAR *LPDIRECTDRAWCOLORCONTROL;
  130. typedef struct IDirectDrawGammaControl          FAR *LPDIRECTDRAWGAMMACONTROL;
  131.  
  132. typedef struct _DDFXROP                 FAR *LPDDFXROP;
  133. typedef struct _DDSURFACEDESC           FAR *LPDDSURFACEDESC;
  134. typedef struct _DDSURFACEDESC2          FAR *LPDDSURFACEDESC2;
  135. typedef struct _DDCOLORCONTROL          FAR *LPDDCOLORCONTROL;
  136.  
  137. /*
  138.  * API's
  139.  */
  140. #if (defined (WIN32) || defined( _WIN32 ) ) && !defined( _NO_COM )
  141. //#if defined( _WIN32 ) && !defined( _NO_ENUM )
  142.     typedef BOOL (FAR PASCAL * LPDDENUMCALLBACKA)(GUID FAR *, LPSTR, LPSTR, LPVOID);
  143.     typedef BOOL (FAR PASCAL * LPDDENUMCALLBACKW)(GUID FAR *, LPWSTR, LPWSTR, LPVOID);
  144.     extern HRESULT WINAPI DirectDrawEnumerateW( LPDDENUMCALLBACKW lpCallback, LPVOID lpContext );
  145.     extern HRESULT WINAPI DirectDrawEnumerateA( LPDDENUMCALLBACKA lpCallback, LPVOID lpContext );
  146.     /*
  147.      * Protect against old SDKs
  148.      */
  149.     #if !defined(HMONITOR_DECLARED) && (WINVER < 0x0500)
  150.         #define HMONITOR_DECLARED
  151.         DECLARE_HANDLE(HMONITOR);
  152.     #endif
  153.     typedef BOOL (FAR PASCAL * LPDDENUMCALLBACKEXA)(GUID FAR *, LPSTR, LPSTR, LPVOID, HMONITOR);
  154.     typedef BOOL (FAR PASCAL * LPDDENUMCALLBACKEXW)(GUID FAR *, LPWSTR, LPWSTR, LPVOID, HMONITOR);
  155.     extern HRESULT WINAPI DirectDrawEnumerateExW( LPDDENUMCALLBACKEXW lpCallback, LPVOID lpContext, DWORD dwFlags);
  156.     extern HRESULT WINAPI DirectDrawEnumerateExA( LPDDENUMCALLBACKEXA lpCallback, LPVOID lpContext, DWORD dwFlags);
  157.     typedef HRESULT (WINAPI * LPDIRECTDRAWENUMERATEEXA)( LPDDENUMCALLBACKEXA lpCallback, LPVOID lpContext, DWORD dwFlags);
  158.     typedef HRESULT (WINAPI * LPDIRECTDRAWENUMERATEEXW)( LPDDENUMCALLBACKEXW lpCallback, LPVOID lpContext, DWORD dwFlags);
  159.  
  160.     #ifdef UNICODE
  161.         typedef LPDDENUMCALLBACKW           LPDDENUMCALLBACK;
  162.         #define DirectDrawEnumerate         DirectDrawEnumerateW
  163.         typedef LPDDENUMCALLBACKEXW         LPDDENUMCALLBACKEX;
  164.         typedef LPDIRECTDRAWENUMERATEEXW        LPDIRECTDRAWENUMERATEEX;
  165.         #define DirectDrawEnumerateEx       DirectDrawEnumerateExW
  166.     #else
  167.         typedef LPDDENUMCALLBACKA           LPDDENUMCALLBACK;
  168.         #define DirectDrawEnumerate         DirectDrawEnumerateA
  169.         typedef LPDDENUMCALLBACKEXA         LPDDENUMCALLBACKEX;
  170.         typedef LPDIRECTDRAWENUMERATEEXA        LPDIRECTDRAWENUMERATEEX;
  171.         #define DirectDrawEnumerateEx       DirectDrawEnumerateExA
  172.     #endif
  173.     extern HRESULT WINAPI DirectDrawCreate( GUID FAR *lpGUID, LPDIRECTDRAW FAR *lplpDD, IUnknown FAR *pUnkOuter );
  174.     extern HRESULT WINAPI DirectDrawCreateEx( GUID FAR * lpGuid, LPVOID  *lplpDD, REFIID  iid,IUnknown FAR *pUnkOuter );
  175.     extern HRESULT WINAPI DirectDrawCreateClipper( DWORD dwFlags, LPDIRECTDRAWCLIPPER FAR *lplpDDClipper, IUnknown FAR *pUnkOuter );
  176. #endif
  177. /*
  178.  * Flags for DirectDrawEnumerateEx
  179.  * DirectDrawEnumerateEx supercedes DirectDrawEnumerate. You must use GetProcAddress to
  180.  * obtain a function pointer (of type LPDIRECTDRAWENUMERATEEX) to DirectDrawEnumerateEx.
  181.  * By default, only the primary display device is enumerated.
  182.  * DirectDrawEnumerate is equivalent to DirectDrawEnumerate(,,DDENUM_NONDISPLAYDEVICES)
  183.  */
  184.  
  185. /*
  186.  * This flag causes enumeration of any GDI display devices which are part of
  187.  * the Windows Desktop
  188.  */
  189. #define DDENUM_ATTACHEDSECONDARYDEVICES     0x00000001L
  190.  
  191. /*
  192.  * This flag causes enumeration of any GDI display devices which are not
  193.  * part of the Windows Desktop
  194.  */
  195. #define DDENUM_DETACHEDSECONDARYDEVICES     0x00000002L
  196.  
  197. /*
  198.  * This flag causes enumeration of non-display devices
  199.  */
  200. #define DDENUM_NONDISPLAYDEVICES            0x00000004L
  201.  
  202.  
  203. #define REGSTR_KEY_DDHW_DESCRIPTION     "Description"
  204. #define REGSTR_KEY_DDHW_DRIVERNAME      "DriverName"
  205. #define REGSTR_PATH_DDHW                "Hardware\\DirectDrawDrivers"
  206.  
  207. #define DDCREATE_HARDWAREONLY           0x00000001l
  208. #define DDCREATE_EMULATIONONLY          0x00000002l
  209.  
  210. #if defined(WINNT) || !defined(WIN32)
  211. typedef long HRESULT;
  212. #endif
  213.  
  214. //#ifndef WINNT
  215. typedef HRESULT (FAR PASCAL * LPDDENUMMODESCALLBACK)(LPDDSURFACEDESC, LPVOID);
  216. typedef HRESULT (FAR PASCAL * LPDDENUMMODESCALLBACK2)(LPDDSURFACEDESC2, LPVOID);
  217. typedef HRESULT (FAR PASCAL * LPDDENUMSURFACESCALLBACK)(LPDIRECTDRAWSURFACE, LPDDSURFACEDESC, LPVOID);
  218. typedef HRESULT (FAR PASCAL * LPDDENUMSURFACESCALLBACK2)(LPDIRECTDRAWSURFACE4, LPDDSURFACEDESC2, LPVOID);
  219. typedef HRESULT (FAR PASCAL * LPDDENUMSURFACESCALLBACK7)(LPDIRECTDRAWSURFACE7, LPDDSURFACEDESC2, LPVOID);
  220. //#endif
  221.  
  222. /*
  223.  * Generic pixel format with 8-bit RGB and alpha components
  224.  */
  225. typedef struct _DDARGB
  226. {
  227.     BYTE blue;
  228.     BYTE green;
  229.     BYTE red;
  230.     BYTE alpha;
  231. } DDARGB;
  232.  
  233. typedef DDARGB FAR *LPDDARGB;
  234.  
  235. /*
  236.  * This version of the structure remains for backwards source compatibility.
  237.  * The DDARGB structure is the one that should be used for all DirectDraw APIs.
  238.  */
  239. typedef struct _DDRGBA
  240. {
  241.     BYTE red;
  242.     BYTE green;
  243.     BYTE blue;
  244.     BYTE alpha;
  245. } DDRGBA;
  246.  
  247. typedef DDRGBA FAR *LPDDRGBA;
  248.  
  249.  
  250. /*
  251.  * DDCOLORKEY
  252.  */
  253. typedef struct _DDCOLORKEY
  254. {
  255.     DWORD       dwColorSpaceLowValue;   // low boundary of color space that is to
  256.                                         // be treated as Color Key, inclusive
  257.     DWORD       dwColorSpaceHighValue;  // high boundary of color space that is
  258.                                         // to be treated as Color Key, inclusive
  259. } DDCOLORKEY;
  260.  
  261. typedef DDCOLORKEY FAR* LPDDCOLORKEY;
  262.  
  263. /*
  264.  * DDBLTFX
  265.  * Used to pass override information to the DIRECTDRAWSURFACE callback Blt.
  266.  */
  267. typedef struct _DDBLTFX
  268. {
  269.     DWORD       dwSize;                         // size of structure
  270.     DWORD       dwDDFX;                         // FX operations
  271.     DWORD       dwROP;                          // Win32 raster operations
  272.     DWORD       dwDDROP;                        // Raster operations new for DirectDraw
  273.     DWORD       dwRotationAngle;                // Rotation angle for blt
  274.     DWORD       dwZBufferOpCode;                // ZBuffer compares
  275.     DWORD       dwZBufferLow;                   // Low limit of Z buffer
  276.     DWORD       dwZBufferHigh;                  // High limit of Z buffer
  277.     DWORD       dwZBufferBaseDest;              // Destination base value
  278.     DWORD       dwZDestConstBitDepth;           // Bit depth used to specify Z constant for destination
  279.     union
  280.     {
  281.         DWORD   dwZDestConst;                   // Constant to use as Z buffer for dest
  282.         LPDIRECTDRAWSURFACE lpDDSZBufferDest;   // Surface to use as Z buffer for dest
  283.     } DUMMYUNIONNAMEN(1);
  284.     DWORD       dwZSrcConstBitDepth;            // Bit depth used to specify Z constant for source
  285.     union
  286.     {
  287.         DWORD   dwZSrcConst;                    // Constant to use as Z buffer for src
  288.         LPDIRECTDRAWSURFACE lpDDSZBufferSrc;    // Surface to use as Z buffer for src
  289.     } DUMMYUNIONNAMEN(2);
  290.     DWORD       dwAlphaEdgeBlendBitDepth;       // Bit depth used to specify constant for alpha edge blend
  291.     DWORD       dwAlphaEdgeBlend;               // Alpha for edge blending
  292.     DWORD       dwReserved;
  293.     DWORD       dwAlphaDestConstBitDepth;       // Bit depth used to specify alpha constant for destination
  294.     union
  295.     {
  296.         DWORD   dwAlphaDestConst;               // Constant to use as Alpha Channel
  297.         LPDIRECTDRAWSURFACE lpDDSAlphaDest;     // Surface to use as Alpha Channel
  298.     } DUMMYUNIONNAMEN(3);
  299.     DWORD       dwAlphaSrcConstBitDepth;        // Bit depth used to specify alpha constant for source
  300.     union
  301.     {
  302.         DWORD   dwAlphaSrcConst;                // Constant to use as Alpha Channel
  303.         LPDIRECTDRAWSURFACE lpDDSAlphaSrc;      // Surface to use as Alpha Channel
  304.     } DUMMYUNIONNAMEN(4);
  305.     union
  306.     {
  307.         DWORD   dwFillColor;                    // color in RGB or Palettized
  308.         DWORD   dwFillDepth;                    // depth value for z-buffer
  309.         DWORD   dwFillPixel;                    // pixel value for RGBA or RGBZ
  310.         LPDIRECTDRAWSURFACE lpDDSPattern;       // Surface to use as pattern
  311.     } DUMMYUNIONNAMEN(5);
  312.     DDCOLORKEY  ddckDestColorkey;               // DestColorkey override
  313.     DDCOLORKEY  ddckSrcColorkey;                // SrcColorkey override
  314. } DDBLTFX;
  315.  
  316. typedef DDBLTFX FAR* LPDDBLTFX;
  317.  
  318.  
  319.  
  320. /*
  321.  * DDSCAPS
  322.  */
  323. typedef struct _DDSCAPS
  324. {
  325.     DWORD       dwCaps;         // capabilities of surface wanted
  326. } DDSCAPS;
  327.  
  328. typedef DDSCAPS FAR* LPDDSCAPS;
  329.  
  330.  
  331. /*
  332.  * DDOSCAPS
  333.  */
  334. typedef struct _DDOSCAPS
  335. {
  336.     DWORD       dwCaps;         // capabilities of surface wanted
  337. } DDOSCAPS;
  338.  
  339. typedef DDOSCAPS FAR* LPDDOSCAPS;
  340.  
  341. /*
  342.  * This structure is used internally by DirectDraw.
  343.  */
  344. typedef struct _DDSCAPSEX
  345. {
  346.     DWORD       dwCaps2;
  347.     DWORD       dwCaps3;
  348.     union
  349.     {
  350.         DWORD       dwCaps4;
  351.         DWORD       dwVolumeDepth;
  352.     } DUMMYUNIONNAMEN(1);
  353. } DDSCAPSEX, FAR * LPDDSCAPSEX;
  354.  
  355. /*
  356.  * DDSCAPS2
  357.  */
  358. typedef struct _DDSCAPS2
  359. {
  360.     DWORD       dwCaps;         // capabilities of surface wanted
  361.     DWORD       dwCaps2;
  362.     DWORD       dwCaps3;
  363.     union
  364.     {
  365.         DWORD       dwCaps4;
  366.         DWORD       dwVolumeDepth;
  367.     } DUMMYUNIONNAMEN(1);
  368. } DDSCAPS2;
  369.  
  370. typedef DDSCAPS2 FAR* LPDDSCAPS2;
  371.  
  372. /*
  373.  * DDCAPS
  374.  */
  375. #define DD_ROP_SPACE            (256/32)        // space required to store ROP array
  376. /*
  377.  * NOTE: Our choosen structure number scheme is to append a single digit to
  378.  * the end of the structure giving the version that structure is associated
  379.  * with.
  380.  */
  381.  
  382. /*
  383.  * This structure represents the DDCAPS structure released in DirectDraw 1.0.  It is used internally
  384.  * by DirectDraw to interpret caps passed into ddraw by drivers written prior to the release of DirectDraw 2.0.
  385.  * New applications should use the DDCAPS structure defined below.
  386.  */
  387. typedef struct _DDCAPS_DX1
  388. {
  389.     DWORD       dwSize;                 // size of the DDDRIVERCAPS structure
  390.     DWORD       dwCaps;                 // driver specific capabilities
  391.     DWORD       dwCaps2;                // more driver specific capabilites
  392.     DWORD       dwCKeyCaps;             // color key capabilities of the surface
  393.     DWORD       dwFXCaps;               // driver specific stretching and effects capabilites
  394.     DWORD       dwFXAlphaCaps;          // alpha driver specific capabilities
  395.     DWORD       dwPalCaps;              // palette capabilities
  396.     DWORD       dwSVCaps;               // stereo vision capabilities
  397.     DWORD       dwAlphaBltConstBitDepths;       // DDBD_2,4,8
  398.     DWORD       dwAlphaBltPixelBitDepths;       // DDBD_1,2,4,8
  399.     DWORD       dwAlphaBltSurfaceBitDepths;     // DDBD_1,2,4,8
  400.     DWORD       dwAlphaOverlayConstBitDepths;   // DDBD_2,4,8
  401.     DWORD       dwAlphaOverlayPixelBitDepths;   // DDBD_1,2,4,8
  402.     DWORD       dwAlphaOverlaySurfaceBitDepths; // DDBD_1,2,4,8
  403.     DWORD       dwZBufferBitDepths;             // DDBD_8,16,24,32
  404.     DWORD       dwVidMemTotal;          // total amount of video memory
  405.     DWORD       dwVidMemFree;           // amount of free video memory
  406.     DWORD       dwMaxVisibleOverlays;   // maximum number of visible overlays
  407.     DWORD       dwCurrVisibleOverlays;  // current number of visible overlays
  408.     DWORD       dwNumFourCCCodes;       // number of four cc codes
  409.     DWORD       dwAlignBoundarySrc;     // source rectangle alignment
  410.     DWORD       dwAlignSizeSrc;         // source rectangle byte size
  411.     DWORD       dwAlignBoundaryDest;    // dest rectangle alignment
  412.     DWORD       dwAlignSizeDest;        // dest rectangle byte size
  413.     DWORD       dwAlignStrideAlign;     // stride alignment
  414.     DWORD       dwRops[DD_ROP_SPACE];   // ROPS supported
  415.     DDSCAPS     ddsCaps;                // DDSCAPS structure has all the general capabilities
  416.     DWORD       dwMinOverlayStretch;    // minimum overlay stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  417.     DWORD       dwMaxOverlayStretch;    // maximum overlay stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  418.     DWORD       dwMinLiveVideoStretch;  // OBSOLETE! This field remains for compatability reasons only
  419.     DWORD       dwMaxLiveVideoStretch;  // OBSOLETE! This field remains for compatability reasons only
  420.     DWORD       dwMinHwCodecStretch;    // OBSOLETE! This field remains for compatability reasons only
  421.     DWORD       dwMaxHwCodecStretch;    // OBSOLETE! This field remains for compatability reasons only
  422.     DWORD       dwReserved1;            // reserved
  423.     DWORD       dwReserved2;            // reserved
  424.     DWORD       dwReserved3;            // reserved
  425. } DDCAPS_DX1;
  426.  
  427. typedef DDCAPS_DX1 FAR* LPDDCAPS_DX1;
  428.  
  429. /*
  430.  * This structure is the DDCAPS structure as it was in version 2 and 3 of Direct X.
  431.  * It is present for back compatability.
  432.  */
  433. typedef struct _DDCAPS_DX3
  434. {
  435.     DWORD       dwSize;                 // size of the DDDRIVERCAPS structure
  436.     DWORD       dwCaps;                 // driver specific capabilities
  437.     DWORD       dwCaps2;                // more driver specific capabilites
  438.     DWORD       dwCKeyCaps;             // color key capabilities of the surface
  439.     DWORD       dwFXCaps;               // driver specific stretching and effects capabilites
  440.     DWORD       dwFXAlphaCaps;          // alpha driver specific capabilities
  441.     DWORD       dwPalCaps;              // palette capabilities
  442.     DWORD       dwSVCaps;               // stereo vision capabilities
  443.     DWORD       dwAlphaBltConstBitDepths;       // DDBD_2,4,8
  444.     DWORD       dwAlphaBltPixelBitDepths;       // DDBD_1,2,4,8
  445.     DWORD       dwAlphaBltSurfaceBitDepths;     // DDBD_1,2,4,8
  446.     DWORD       dwAlphaOverlayConstBitDepths;   // DDBD_2,4,8
  447.     DWORD       dwAlphaOverlayPixelBitDepths;   // DDBD_1,2,4,8
  448.     DWORD       dwAlphaOverlaySurfaceBitDepths; // DDBD_1,2,4,8
  449.     DWORD       dwZBufferBitDepths;             // DDBD_8,16,24,32
  450.     DWORD       dwVidMemTotal;          // total amount of video memory
  451.     DWORD       dwVidMemFree;           // amount of free video memory
  452.     DWORD       dwMaxVisibleOverlays;   // maximum number of visible overlays
  453.     DWORD       dwCurrVisibleOverlays;  // current number of visible overlays
  454.     DWORD       dwNumFourCCCodes;       // number of four cc codes
  455.     DWORD       dwAlignBoundarySrc;     // source rectangle alignment
  456.     DWORD       dwAlignSizeSrc;         // source rectangle byte size
  457.     DWORD       dwAlignBoundaryDest;    // dest rectangle alignment
  458.     DWORD       dwAlignSizeDest;        // dest rectangle byte size
  459.     DWORD       dwAlignStrideAlign;     // stride alignment
  460.     DWORD       dwRops[DD_ROP_SPACE];   // ROPS supported
  461.     DDSCAPS     ddsCaps;                // DDSCAPS structure has all the general capabilities
  462.     DWORD       dwMinOverlayStretch;    // minimum overlay stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  463.     DWORD       dwMaxOverlayStretch;    // maximum overlay stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  464.     DWORD       dwMinLiveVideoStretch;  // minimum live video stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  465.     DWORD       dwMaxLiveVideoStretch;  // maximum live video stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  466.     DWORD       dwMinHwCodecStretch;    // minimum hardware codec stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  467.     DWORD       dwMaxHwCodecStretch;    // maximum hardware codec stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  468.     DWORD       dwReserved1;            // reserved
  469.     DWORD       dwReserved2;            // reserved
  470.     DWORD       dwReserved3;            // reserved
  471.     DWORD       dwSVBCaps;              // driver specific capabilities for System->Vmem blts
  472.     DWORD       dwSVBCKeyCaps;          // driver color key capabilities for System->Vmem blts
  473.     DWORD       dwSVBFXCaps;            // driver FX capabilities for System->Vmem blts
  474.     DWORD       dwSVBRops[DD_ROP_SPACE];// ROPS supported for System->Vmem blts
  475.     DWORD       dwVSBCaps;              // driver specific capabilities for Vmem->System blts
  476.     DWORD       dwVSBCKeyCaps;          // driver color key capabilities for Vmem->System blts
  477.     DWORD       dwVSBFXCaps;            // driver FX capabilities for Vmem->System blts
  478.     DWORD       dwVSBRops[DD_ROP_SPACE];// ROPS supported for Vmem->System blts
  479.     DWORD       dwSSBCaps;              // driver specific capabilities for System->System blts
  480.     DWORD       dwSSBCKeyCaps;          // driver color key capabilities for System->System blts
  481.     DWORD       dwSSBFXCaps;            // driver FX capabilities for System->System blts
  482.     DWORD       dwSSBRops[DD_ROP_SPACE];// ROPS supported for System->System blts
  483.     DWORD       dwReserved4;            // reserved
  484.     DWORD       dwReserved5;            // reserved
  485.     DWORD       dwReserved6;            // reserved
  486. } DDCAPS_DX3;
  487. typedef DDCAPS_DX3 FAR* LPDDCAPS_DX3;
  488.  
  489. /*
  490.  * This structure is the DDCAPS structure as it was in version 5 of Direct X.
  491.  * It is present for back compatability.
  492.  */
  493. typedef struct _DDCAPS_DX5
  494. {
  495. /*  0*/ DWORD   dwSize;                 // size of the DDDRIVERCAPS structure
  496. /*  4*/ DWORD   dwCaps;                 // driver specific capabilities
  497. /*  8*/ DWORD   dwCaps2;                // more driver specific capabilites
  498. /*  c*/ DWORD   dwCKeyCaps;             // color key capabilities of the surface
  499. /* 10*/ DWORD   dwFXCaps;               // driver specific stretching and effects capabilites
  500. /* 14*/ DWORD   dwFXAlphaCaps;          // alpha driver specific capabilities
  501. /* 18*/ DWORD   dwPalCaps;              // palette capabilities
  502. /* 1c*/ DWORD   dwSVCaps;               // stereo vision capabilities
  503. /* 20*/ DWORD   dwAlphaBltConstBitDepths;       // DDBD_2,4,8
  504. /* 24*/ DWORD   dwAlphaBltPixelBitDepths;       // DDBD_1,2,4,8
  505. /* 28*/ DWORD   dwAlphaBltSurfaceBitDepths;     // DDBD_1,2,4,8
  506. /* 2c*/ DWORD   dwAlphaOverlayConstBitDepths;   // DDBD_2,4,8
  507. /* 30*/ DWORD   dwAlphaOverlayPixelBitDepths;   // DDBD_1,2,4,8
  508. /* 34*/ DWORD   dwAlphaOverlaySurfaceBitDepths; // DDBD_1,2,4,8
  509. /* 38*/ DWORD   dwZBufferBitDepths;             // DDBD_8,16,24,32
  510. /* 3c*/ DWORD   dwVidMemTotal;          // total amount of video memory
  511. /* 40*/ DWORD   dwVidMemFree;           // amount of free video memory
  512. /* 44*/ DWORD   dwMaxVisibleOverlays;   // maximum number of visible overlays
  513. /* 48*/ DWORD   dwCurrVisibleOverlays;  // current number of visible overlays
  514. /* 4c*/ DWORD   dwNumFourCCCodes;       // number of four cc codes
  515. /* 50*/ DWORD   dwAlignBoundarySrc;     // source rectangle alignment
  516. /* 54*/ DWORD   dwAlignSizeSrc;         // source rectangle byte size
  517. /* 58*/ DWORD   dwAlignBoundaryDest;    // dest rectangle alignment
  518. /* 5c*/ DWORD   dwAlignSizeDest;        // dest rectangle byte size
  519. /* 60*/ DWORD   dwAlignStrideAlign;     // stride alignment
  520. /* 64*/ DWORD   dwRops[DD_ROP_SPACE];   // ROPS supported
  521. /* 84*/ DDSCAPS ddsCaps;                // DDSCAPS structure has all the general capabilities
  522. /* 88*/ DWORD   dwMinOverlayStretch;    // minimum overlay stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  523. /* 8c*/ DWORD   dwMaxOverlayStretch;    // maximum overlay stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  524. /* 90*/ DWORD   dwMinLiveVideoStretch;  // minimum live video stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  525. /* 94*/ DWORD   dwMaxLiveVideoStretch;  // maximum live video stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  526. /* 98*/ DWORD   dwMinHwCodecStretch;    // minimum hardware codec stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  527. /* 9c*/ DWORD   dwMaxHwCodecStretch;    // maximum hardware codec stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  528. /* a0*/ DWORD   dwReserved1;            // reserved
  529. /* a4*/ DWORD   dwReserved2;            // reserved
  530. /* a8*/ DWORD   dwReserved3;            // reserved
  531. /* ac*/ DWORD   dwSVBCaps;              // driver specific capabilities for System->Vmem blts
  532. /* b0*/ DWORD   dwSVBCKeyCaps;          // driver color key capabilities for System->Vmem blts
  533. /* b4*/ DWORD   dwSVBFXCaps;            // driver FX capabilities for System->Vmem blts
  534. /* b8*/ DWORD   dwSVBRops[DD_ROP_SPACE];// ROPS supported for System->Vmem blts
  535. /* d8*/ DWORD   dwVSBCaps;              // driver specific capabilities for Vmem->System blts
  536. /* dc*/ DWORD   dwVSBCKeyCaps;          // driver color key capabilities for Vmem->System blts
  537. /* e0*/ DWORD   dwVSBFXCaps;            // driver FX capabilities for Vmem->System blts
  538. /* e4*/ DWORD   dwVSBRops[DD_ROP_SPACE];// ROPS supported for Vmem->System blts
  539. /*104*/ DWORD   dwSSBCaps;              // driver specific capabilities for System->System blts
  540. /*108*/ DWORD   dwSSBCKeyCaps;          // driver color key capabilities for System->System blts
  541. /*10c*/ DWORD   dwSSBFXCaps;            // driver FX capabilities for System->System blts
  542. /*110*/ DWORD   dwSSBRops[DD_ROP_SPACE];// ROPS supported for System->System blts
  543. // Members added for DX5:
  544. /*130*/ DWORD   dwMaxVideoPorts;        // maximum number of usable video ports
  545. /*134*/ DWORD   dwCurrVideoPorts;       // current number of video ports used
  546. /*138*/ DWORD   dwSVBCaps2;             // more driver specific capabilities for System->Vmem blts
  547. /*13c*/ DWORD   dwNLVBCaps;               // driver specific capabilities for non-local->local vidmem blts
  548. /*140*/ DWORD   dwNLVBCaps2;              // more driver specific capabilities non-local->local vidmem blts
  549. /*144*/ DWORD   dwNLVBCKeyCaps;           // driver color key capabilities for non-local->local vidmem blts
  550. /*148*/ DWORD   dwNLVBFXCaps;             // driver FX capabilities for non-local->local blts
  551. /*14c*/ DWORD   dwNLVBRops[DD_ROP_SPACE]; // ROPS supported for non-local->local blts
  552. } DDCAPS_DX5;
  553. typedef DDCAPS_DX5 FAR* LPDDCAPS_DX5;
  554.  
  555. typedef struct _DDCAPS_DX6
  556. {
  557. /*  0*/ DWORD   dwSize;                 // size of the DDDRIVERCAPS structure
  558. /*  4*/ DWORD   dwCaps;                 // driver specific capabilities
  559. /*  8*/ DWORD   dwCaps2;                // more driver specific capabilites
  560. /*  c*/ DWORD   dwCKeyCaps;             // color key capabilities of the surface
  561. /* 10*/ DWORD   dwFXCaps;               // driver specific stretching and effects capabilites
  562. /* 14*/ DWORD   dwFXAlphaCaps;          // alpha caps
  563. /* 18*/ DWORD   dwPalCaps;              // palette capabilities
  564. /* 1c*/ DWORD   dwSVCaps;               // stereo vision capabilities
  565. /* 20*/ DWORD   dwAlphaBltConstBitDepths;       // DDBD_2,4,8
  566. /* 24*/ DWORD   dwAlphaBltPixelBitDepths;       // DDBD_1,2,4,8
  567. /* 28*/ DWORD   dwAlphaBltSurfaceBitDepths;     // DDBD_1,2,4,8
  568. /* 2c*/ DWORD   dwAlphaOverlayConstBitDepths;   // DDBD_2,4,8
  569. /* 30*/ DWORD   dwAlphaOverlayPixelBitDepths;   // DDBD_1,2,4,8
  570. /* 34*/ DWORD   dwAlphaOverlaySurfaceBitDepths; // DDBD_1,2,4,8
  571. /* 38*/ DWORD   dwZBufferBitDepths;             // DDBD_8,16,24,32
  572. /* 3c*/ DWORD   dwVidMemTotal;          // total amount of video memory
  573. /* 40*/ DWORD   dwVidMemFree;           // amount of free video memory
  574. /* 44*/ DWORD   dwMaxVisibleOverlays;   // maximum number of visible overlays
  575. /* 48*/ DWORD   dwCurrVisibleOverlays;  // current number of visible overlays
  576. /* 4c*/ DWORD   dwNumFourCCCodes;       // number of four cc codes
  577. /* 50*/ DWORD   dwAlignBoundarySrc;     // source rectangle alignment
  578. /* 54*/ DWORD   dwAlignSizeSrc;         // source rectangle byte size
  579. /* 58*/ DWORD   dwAlignBoundaryDest;    // dest rectangle alignment
  580. /* 5c*/ DWORD   dwAlignSizeDest;        // dest rectangle byte size
  581. /* 60*/ DWORD   dwAlignStrideAlign;     // stride alignment
  582. /* 64*/ DWORD   dwRops[DD_ROP_SPACE];   // ROPS supported
  583. /* 84*/ DDSCAPS ddsOldCaps;             // Was DDSCAPS  ddsCaps. ddsCaps is of type DDSCAPS2 for DX6
  584. /* 88*/ DWORD   dwMinOverlayStretch;    // minimum overlay stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  585. /* 8c*/ DWORD   dwMaxOverlayStretch;    // maximum overlay stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  586. /* 90*/ DWORD   dwMinLiveVideoStretch;  // minimum live video stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  587. /* 94*/ DWORD   dwMaxLiveVideoStretch;  // maximum live video stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  588. /* 98*/ DWORD   dwMinHwCodecStretch;    // minimum hardware codec stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  589. /* 9c*/ DWORD   dwMaxHwCodecStretch;    // maximum hardware codec stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  590. /* a0*/ DWORD   dwReserved1;            // reserved
  591. /* a4*/ DWORD   dwReserved2;            // reserved
  592. /* a8*/ DWORD   dwReserved3;            // reserved
  593. /* ac*/ DWORD   dwSVBCaps;              // driver specific capabilities for System->Vmem blts
  594. /* b0*/ DWORD   dwSVBCKeyCaps;          // driver color key capabilities for System->Vmem blts
  595. /* b4*/ DWORD   dwSVBFXCaps;            // driver FX capabilities for System->Vmem blts
  596. /* b8*/ DWORD   dwSVBRops[DD_ROP_SPACE];// ROPS supported for System->Vmem blts
  597. /* d8*/ DWORD   dwVSBCaps;              // driver specific capabilities for Vmem->System blts
  598. /* dc*/ DWORD   dwVSBCKeyCaps;          // driver color key capabilities for Vmem->System blts
  599. /* e0*/ DWORD   dwVSBFXCaps;            // driver FX capabilities for Vmem->System blts
  600. /* e4*/ DWORD   dwVSBRops[DD_ROP_SPACE];// ROPS supported for Vmem->System blts
  601. /*104*/ DWORD   dwSSBCaps;              // driver specific capabilities for System->System blts
  602. /*108*/ DWORD   dwSSBCKeyCaps;          // driver color key capabilities for System->System blts
  603. /*10c*/ DWORD   dwSSBFXCaps;            // driver FX capabilities for System->System blts
  604. /*110*/ DWORD   dwSSBRops[DD_ROP_SPACE];// ROPS supported for System->System blts
  605. /*130*/ DWORD   dwMaxVideoPorts;        // maximum number of usable video ports
  606. /*134*/ DWORD   dwCurrVideoPorts;       // current number of video ports used
  607. /*138*/ DWORD   dwSVBCaps2;             // more driver specific capabilities for System->Vmem blts
  608. /*13c*/ DWORD   dwNLVBCaps;               // driver specific capabilities for non-local->local vidmem blts
  609. /*140*/ DWORD   dwNLVBCaps2;              // more driver specific capabilities non-local->local vidmem blts
  610. /*144*/ DWORD   dwNLVBCKeyCaps;           // driver color key capabilities for non-local->local vidmem blts
  611. /*148*/ DWORD   dwNLVBFXCaps;             // driver FX capabilities for non-local->local blts
  612. /*14c*/ DWORD   dwNLVBRops[DD_ROP_SPACE]; // ROPS supported for non-local->local blts
  613. // Members added for DX6 release
  614. /*16c*/ DDSCAPS2 ddsCaps;               // Surface Caps
  615. } DDCAPS_DX6;
  616. typedef DDCAPS_DX6 FAR* LPDDCAPS_DX6;
  617.  
  618. typedef struct _DDCAPS_DX7
  619. {
  620. /*  0*/ DWORD   dwSize;                 // size of the DDDRIVERCAPS structure
  621. /*  4*/ DWORD   dwCaps;                 // driver specific capabilities
  622. /*  8*/ DWORD   dwCaps2;                // more driver specific capabilites
  623. /*  c*/ DWORD   dwCKeyCaps;             // color key capabilities of the surface
  624. /* 10*/ DWORD   dwFXCaps;               // driver specific stretching and effects capabilites
  625. /* 14*/ DWORD   dwFXAlphaCaps;          // alpha driver specific capabilities
  626. /* 18*/ DWORD   dwPalCaps;              // palette capabilities
  627. /* 1c*/ DWORD   dwSVCaps;               // stereo vision capabilities
  628. /* 20*/ DWORD   dwAlphaBltConstBitDepths;       // DDBD_2,4,8
  629. /* 24*/ DWORD   dwAlphaBltPixelBitDepths;       // DDBD_1,2,4,8
  630. /* 28*/ DWORD   dwAlphaBltSurfaceBitDepths;     // DDBD_1,2,4,8
  631. /* 2c*/ DWORD   dwAlphaOverlayConstBitDepths;   // DDBD_2,4,8
  632. /* 30*/ DWORD   dwAlphaOverlayPixelBitDepths;   // DDBD_1,2,4,8
  633. /* 34*/ DWORD   dwAlphaOverlaySurfaceBitDepths; // DDBD_1,2,4,8
  634. /* 38*/ DWORD   dwZBufferBitDepths;             // DDBD_8,16,24,32
  635. /* 3c*/ DWORD   dwVidMemTotal;          // total amount of video memory
  636. /* 40*/ DWORD   dwVidMemFree;           // amount of free video memory
  637. /* 44*/ DWORD   dwMaxVisibleOverlays;   // maximum number of visible overlays
  638. /* 48*/ DWORD   dwCurrVisibleOverlays;  // current number of visible overlays
  639. /* 4c*/ DWORD   dwNumFourCCCodes;       // number of four cc codes
  640. /* 50*/ DWORD   dwAlignBoundarySrc;     // source rectangle alignment
  641. /* 54*/ DWORD   dwAlignSizeSrc;         // source rectangle byte size
  642. /* 58*/ DWORD   dwAlignBoundaryDest;    // dest rectangle alignment
  643. /* 5c*/ DWORD   dwAlignSizeDest;        // dest rectangle byte size
  644. /* 60*/ DWORD   dwAlignStrideAlign;     // stride alignment
  645. /* 64*/ DWORD   dwRops[DD_ROP_SPACE];   // ROPS supported
  646. /* 84*/ DDSCAPS ddsOldCaps;             // Was DDSCAPS  ddsCaps. ddsCaps is of type DDSCAPS2 for DX6
  647. /* 88*/ DWORD   dwMinOverlayStretch;    // minimum overlay stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  648. /* 8c*/ DWORD   dwMaxOverlayStretch;    // maximum overlay stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  649. /* 90*/ DWORD   dwMinLiveVideoStretch;  // minimum live video stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  650. /* 94*/ DWORD   dwMaxLiveVideoStretch;  // maximum live video stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  651. /* 98*/ DWORD   dwMinHwCodecStretch;    // minimum hardware codec stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  652. /* 9c*/ DWORD   dwMaxHwCodecStretch;    // maximum hardware codec stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  653. /* a0*/ DWORD   dwReserved1;            // reserved
  654. /* a4*/ DWORD   dwReserved2;            // reserved
  655. /* a8*/ DWORD   dwReserved3;            // reserved
  656. /* ac*/ DWORD   dwSVBCaps;              // driver specific capabilities for System->Vmem blts
  657. /* b0*/ DWORD   dwSVBCKeyCaps;          // driver color key capabilities for System->Vmem blts
  658. /* b4*/ DWORD   dwSVBFXCaps;            // driver FX capabilities for System->Vmem blts
  659. /* b8*/ DWORD   dwSVBRops[DD_ROP_SPACE];// ROPS supported for System->Vmem blts
  660. /* d8*/ DWORD   dwVSBCaps;              // driver specific capabilities for Vmem->System blts
  661. /* dc*/ DWORD   dwVSBCKeyCaps;          // driver color key capabilities for Vmem->System blts
  662. /* e0*/ DWORD   dwVSBFXCaps;            // driver FX capabilities for Vmem->System blts
  663. /* e4*/ DWORD   dwVSBRops[DD_ROP_SPACE];// ROPS supported for Vmem->System blts
  664. /*104*/ DWORD   dwSSBCaps;              // driver specific capabilities for System->System blts
  665. /*108*/ DWORD   dwSSBCKeyCaps;          // driver color key capabilities for System->System blts
  666. /*10c*/ DWORD   dwSSBFXCaps;            // driver FX capabilities for System->System blts
  667. /*110*/ DWORD   dwSSBRops[DD_ROP_SPACE];// ROPS supported for System->System blts
  668. /*130*/ DWORD   dwMaxVideoPorts;        // maximum number of usable video ports
  669. /*134*/ DWORD   dwCurrVideoPorts;       // current number of video ports used
  670. /*138*/ DWORD   dwSVBCaps2;             // more driver specific capabilities for System->Vmem blts
  671. /*13c*/ DWORD   dwNLVBCaps;               // driver specific capabilities for non-local->local vidmem blts
  672. /*140*/ DWORD   dwNLVBCaps2;              // more driver specific capabilities non-local->local vidmem blts
  673. /*144*/ DWORD   dwNLVBCKeyCaps;           // driver color key capabilities for non-local->local vidmem blts
  674. /*148*/ DWORD   dwNLVBFXCaps;             // driver FX capabilities for non-local->local blts
  675. /*14c*/ DWORD   dwNLVBRops[DD_ROP_SPACE]; // ROPS supported for non-local->local blts
  676. // Members added for DX6 release
  677. /*16c*/ DDSCAPS2 ddsCaps;               // Surface Caps
  678. } DDCAPS_DX7;
  679. typedef DDCAPS_DX7 FAR* LPDDCAPS_DX7;
  680.  
  681.  
  682. #if DIRECTDRAW_VERSION <= 0x300
  683.     typedef DDCAPS_DX3 DDCAPS;
  684. #elif DIRECTDRAW_VERSION <= 0x500
  685.     typedef DDCAPS_DX5 DDCAPS;
  686. #elif DIRECTDRAW_VERSION <= 0x600
  687.     typedef DDCAPS_DX6 DDCAPS;
  688. #else
  689.     typedef DDCAPS_DX7 DDCAPS;
  690. #endif
  691.  
  692. typedef DDCAPS FAR* LPDDCAPS;
  693.  
  694.  
  695.  
  696. /*
  697.  * DDPIXELFORMAT
  698.  */
  699. typedef struct _DDPIXELFORMAT
  700. {
  701.     DWORD       dwSize;                 // size of structure
  702.     DWORD       dwFlags;                // pixel format flags
  703.     DWORD       dwFourCC;               // (FOURCC code)
  704.     union
  705.     {
  706.         DWORD   dwRGBBitCount;          // how many bits per pixel
  707.         DWORD   dwYUVBitCount;          // how many bits per pixel
  708.         DWORD   dwZBufferBitDepth;      // how many total bits/pixel in z buffer (including any stencil bits)
  709.         DWORD   dwAlphaBitDepth;        // how many bits for alpha channels
  710.         DWORD   dwLuminanceBitCount;    // how many bits per pixel
  711.         DWORD   dwBumpBitCount;         // how many bits per "buxel", total
  712.         DWORD   dwPrivateFormatBitCount;// Bits per pixel of private driver formats. Only valid in texture
  713.                                         // format list and if DDPF_D3DFORMAT is set
  714.     } DUMMYUNIONNAMEN(1);
  715.     union
  716.     {
  717.         DWORD   dwRBitMask;             // mask for red bit
  718.         DWORD   dwYBitMask;             // mask for Y bits
  719.         DWORD   dwStencilBitDepth;      // how many stencil bits (note: dwZBufferBitDepth-dwStencilBitDepth is total Z-only bits)
  720.         DWORD   dwLuminanceBitMask;     // mask for luminance bits
  721.         DWORD   dwBumpDuBitMask;        // mask for bump map U delta bits
  722.         DWORD   dwOperations;           // DDPF_D3DFORMAT Operations
  723.     } DUMMYUNIONNAMEN(2);
  724.     union
  725.     {
  726.         DWORD   dwGBitMask;             // mask for green bits
  727.         DWORD   dwUBitMask;             // mask for U bits
  728.         DWORD   dwZBitMask;             // mask for Z bits
  729.         DWORD   dwBumpDvBitMask;        // mask for bump map V delta bits
  730.         struct
  731.         {
  732.             WORD    wFlipMSTypes;       // Multisample methods supported via flip for this D3DFORMAT
  733.             WORD    wBltMSTypes;        // Multisample methods supported via blt for this D3DFORMAT
  734.         } MultiSampleCaps;
  735.  
  736.     } DUMMYUNIONNAMEN(3);
  737.     union
  738.     {
  739.         DWORD   dwBBitMask;             // mask for blue bits
  740.         DWORD   dwVBitMask;             // mask for V bits
  741.         DWORD   dwStencilBitMask;       // mask for stencil bits
  742.         DWORD   dwBumpLuminanceBitMask; // mask for luminance in bump map
  743.     } DUMMYUNIONNAMEN(4);
  744.     union
  745.     {
  746.         DWORD   dwRGBAlphaBitMask;      // mask for alpha channel
  747.         DWORD   dwYUVAlphaBitMask;      // mask for alpha channel
  748.         DWORD   dwLuminanceAlphaBitMask;// mask for alpha channel
  749.         DWORD   dwRGBZBitMask;          // mask for Z channel
  750.         DWORD   dwYUVZBitMask;          // mask for Z channel
  751.     } DUMMYUNIONNAMEN(5);
  752. } DDPIXELFORMAT;
  753.  
  754. typedef DDPIXELFORMAT FAR* LPDDPIXELFORMAT;
  755.  
  756. /*
  757.  * DDOVERLAYFX
  758.  */
  759. typedef struct _DDOVERLAYFX
  760. {
  761.     DWORD       dwSize;                         // size of structure
  762.     DWORD       dwAlphaEdgeBlendBitDepth;       // Bit depth used to specify constant for alpha edge blend
  763.     DWORD       dwAlphaEdgeBlend;               // Constant to use as alpha for edge blend
  764.     DWORD       dwReserved;
  765.     DWORD       dwAlphaDestConstBitDepth;       // Bit depth used to specify alpha constant for destination
  766.     union
  767.     {
  768.         DWORD   dwAlphaDestConst;               // Constant to use as alpha channel for dest
  769.         LPDIRECTDRAWSURFACE lpDDSAlphaDest;     // Surface to use as alpha channel for dest
  770.     } DUMMYUNIONNAMEN(1);
  771.     DWORD       dwAlphaSrcConstBitDepth;        // Bit depth used to specify alpha constant for source
  772.     union
  773.     {
  774.         DWORD   dwAlphaSrcConst;                // Constant to use as alpha channel for src
  775.         LPDIRECTDRAWSURFACE lpDDSAlphaSrc;      // Surface to use as alpha channel for src
  776.     } DUMMYUNIONNAMEN(2);
  777.     DDCOLORKEY  dckDestColorkey;                // DestColorkey override
  778.     DDCOLORKEY  dckSrcColorkey;                 // DestColorkey override
  779.     DWORD       dwDDFX;                         // Overlay FX
  780.     DWORD       dwFlags;                        // flags
  781. } DDOVERLAYFX;
  782.  
  783. typedef DDOVERLAYFX FAR *LPDDOVERLAYFX;
  784.  
  785.  
  786. /*
  787.  * DDBLTBATCH: BltBatch entry structure
  788.  */
  789. typedef struct _DDBLTBATCH
  790. {
  791.     LPRECT              lprDest;
  792.     LPDIRECTDRAWSURFACE lpDDSSrc;
  793.     LPRECT              lprSrc;
  794.     DWORD               dwFlags;
  795.     LPDDBLTFX           lpDDBltFx;
  796. } DDBLTBATCH;
  797.  
  798. typedef DDBLTBATCH FAR * LPDDBLTBATCH;
  799.  
  800.  
  801. /*
  802.  * DDGAMMARAMP
  803.  */
  804. typedef struct _DDGAMMARAMP
  805. {
  806.     WORD                red[256];
  807.     WORD                green[256];
  808.     WORD                blue[256];
  809. } DDGAMMARAMP;
  810. typedef DDGAMMARAMP FAR * LPDDGAMMARAMP;
  811.  
  812. /*
  813.  *  This is the structure within which DirectDraw returns data about the current graphics driver and chipset
  814.  */
  815.  
  816. #define MAX_DDDEVICEID_STRING           512
  817.  
  818. typedef struct tagDDDEVICEIDENTIFIER
  819. {
  820.     /*
  821.      * These elements are for presentation to the user only. They should not be used to identify particular
  822.      * drivers, since this is unreliable and many different strings may be associated with the same
  823.      * device, and the same driver from different vendors.
  824.      */
  825.     char    szDriver[MAX_DDDEVICEID_STRING];
  826.     char    szDescription[MAX_DDDEVICEID_STRING];
  827.  
  828.     /*
  829.      * This element is the version of the DirectDraw/3D driver. It is legal to do <, > comparisons
  830.      * on the whole 64 bits. Caution should be exercised if you use this element to identify problematic
  831.      * drivers. It is recommended that guidDeviceIdentifier is used for this purpose.
  832.      *
  833.      * This version has the form:
  834.      *  wProduct = HIWORD(liDriverVersion.HighPart)
  835.      *  wVersion = LOWORD(liDriverVersion.HighPart)
  836.      *  wSubVersion = HIWORD(liDriverVersion.LowPart)
  837.      *  wBuild = LOWORD(liDriverVersion.LowPart)
  838.      */
  839. #ifdef _WIN32
  840.     LARGE_INTEGER liDriverVersion;      /* Defined for applications and other 32 bit components */
  841. #else
  842.     DWORD   dwDriverVersionLowPart;     /* Defined for 16 bit driver components */
  843.     DWORD   dwDriverVersionHighPart;
  844. #endif
  845.  
  846.  
  847.     /*
  848.      * These elements can be used to identify particular chipsets. Use with extreme caution.
  849.      *   dwVendorId     Identifies the manufacturer. May be zero if unknown.
  850.      *   dwDeviceId     Identifies the type of chipset. May be zero if unknown.
  851.      *   dwSubSysId     Identifies the subsystem, typically this means the particular board. May be zero if unknown.
  852.      *   dwRevision     Identifies the revision level of the chipset. May be zero if unknown.
  853.      */
  854.     DWORD   dwVendorId;
  855.     DWORD   dwDeviceId;
  856.     DWORD   dwSubSysId;
  857.     DWORD   dwRevision;
  858.  
  859.     /*
  860.      * This element can be used to check changes in driver/chipset. This GUID is a unique identifier for the
  861.      * driver/chipset pair. Use this element if you wish to track changes to the driver/chipset in order to
  862.      * reprofile the graphics subsystem.
  863.      * This element can also be used to identify particular problematic drivers.
  864.      */
  865.     GUID    guidDeviceIdentifier;
  866. } DDDEVICEIDENTIFIER, * LPDDDEVICEIDENTIFIER;
  867.  
  868. typedef struct tagDDDEVICEIDENTIFIER2
  869. {
  870.     /*
  871.      * These elements are for presentation to the user only. They should not be used to identify particular
  872.      * drivers, since this is unreliable and many different strings may be associated with the same
  873.      * device, and the same driver from different vendors.
  874.      */
  875.     char    szDriver[MAX_DDDEVICEID_STRING];
  876.     char    szDescription[MAX_DDDEVICEID_STRING];
  877.  
  878.     /*
  879.      * This element is the version of the DirectDraw/3D driver. It is legal to do <, > comparisons
  880.      * on the whole 64 bits. Caution should be exercised if you use this element to identify problematic
  881.      * drivers. It is recommended that guidDeviceIdentifier is used for this purpose.
  882.      *
  883.      * This version has the form:
  884.      *  wProduct = HIWORD(liDriverVersion.HighPart)
  885.      *  wVersion = LOWORD(liDriverVersion.HighPart)
  886.      *  wSubVersion = HIWORD(liDriverVersion.LowPart)
  887.      *  wBuild = LOWORD(liDriverVersion.LowPart)
  888.      */
  889. #ifdef _WIN32
  890.     LARGE_INTEGER liDriverVersion;      /* Defined for applications and other 32 bit components */
  891. #else
  892.     DWORD   dwDriverVersionLowPart;     /* Defined for 16 bit driver components */
  893.     DWORD   dwDriverVersionHighPart;
  894. #endif
  895.  
  896.  
  897.     /*
  898.      * These elements can be used to identify particular chipsets. Use with extreme caution.
  899.      *   dwVendorId     Identifies the manufacturer. May be zero if unknown.
  900.      *   dwDeviceId     Identifies the type of chipset. May be zero if unknown.
  901.      *   dwSubSysId     Identifies the subsystem, typically this means the particular board. May be zero if unknown.
  902.      *   dwRevision     Identifies the revision level of the chipset. May be zero if unknown.
  903.      */
  904.     DWORD   dwVendorId;
  905.     DWORD   dwDeviceId;
  906.     DWORD   dwSubSysId;
  907.     DWORD   dwRevision;
  908.  
  909.     /*
  910.      * This element can be used to check changes in driver/chipset. This GUID is a unique identifier for the
  911.      * driver/chipset pair. Use this element if you wish to track changes to the driver/chipset in order to
  912.      * reprofile the graphics subsystem.
  913.      * This element can also be used to identify particular problematic drivers.
  914.      */
  915.     GUID    guidDeviceIdentifier;
  916.  
  917.     /*
  918.      * This element is used to determine the Windows Hardware Quality Lab (WHQL)
  919.      * certification level for this driver/device pair.
  920.      */
  921.     DWORD   dwWHQLLevel;
  922.  
  923. } DDDEVICEIDENTIFIER2, * LPDDDEVICEIDENTIFIER2;
  924.  
  925. /*
  926.  * Flags for the IDirectDraw4::GetDeviceIdentifier method
  927.  */
  928.  
  929. /*
  930.  * This flag causes GetDeviceIdentifier to return information about the host (typically 2D) adapter in a system equipped
  931.  * with a stacked secondary 3D adapter. Such an adapter appears to the application as if it were part of the
  932.  * host adapter, but is typically physcially located on a separate card. The stacked secondary's information is
  933.  * returned when GetDeviceIdentifier's dwFlags field is zero, since this most accurately reflects the qualities
  934.  * of the DirectDraw object involved.
  935.  */
  936. #define DDGDI_GETHOSTIDENTIFIER         0x00000001L
  937.  
  938. /*
  939.  * Macros for interpretting DDEVICEIDENTIFIER2.dwWHQLLevel
  940.  */
  941. #define GET_WHQL_YEAR( dwWHQLLevel ) \
  942.     ( (dwWHQLLevel) / 0x10000 )
  943. #define GET_WHQL_MONTH( dwWHQLLevel ) \
  944.     ( ( (dwWHQLLevel) / 0x100 ) & 0x00ff )
  945. #define GET_WHQL_DAY( dwWHQLLevel ) \
  946.     ( (dwWHQLLevel) & 0xff )
  947.  
  948.  
  949. /*
  950.  * callbacks
  951.  */
  952. typedef DWORD   (FAR PASCAL *LPCLIPPERCALLBACK)(LPDIRECTDRAWCLIPPER lpDDClipper, HWND hWnd, DWORD code, LPVOID lpContext );
  953. #ifdef STREAMING
  954. typedef DWORD   (FAR PASCAL *LPSURFACESTREAMINGCALLBACK)(DWORD);
  955. #endif
  956.  
  957.  
  958. /*
  959.  * INTERACES FOLLOW:
  960.  *      IDirectDraw
  961.  *      IDirectDrawClipper
  962.  *      IDirectDrawPalette
  963.  *      IDirectDrawSurface
  964.  */
  965.  
  966. /*
  967.  * IDirectDraw
  968.  */
  969. #if defined( _WIN32 ) && !defined( _NO_COM )
  970. #undef INTERFACE
  971. #define INTERFACE IDirectDraw
  972. DECLARE_INTERFACE_( IDirectDraw, IUnknown )
  973. {
  974.     /*** IUnknown methods ***/
  975.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE;
  976.     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
  977.     STDMETHOD_(ULONG,Release) (THIS) PURE;
  978.     /*** IDirectDraw methods ***/
  979.     STDMETHOD(Compact)(THIS) PURE;
  980.     STDMETHOD(CreateClipper)(THIS_ DWORD, LPDIRECTDRAWCLIPPER FAR*, IUnknown FAR * ) PURE;
  981.     STDMETHOD(CreatePalette)(THIS_ DWORD, LPPALETTEENTRY, LPDIRECTDRAWPALETTE FAR*, IUnknown FAR * ) PURE;
  982.     STDMETHOD(CreateSurface)(THIS_  LPDDSURFACEDESC, LPDIRECTDRAWSURFACE FAR *, IUnknown FAR *) PURE;
  983.     STDMETHOD(DuplicateSurface)( THIS_ LPDIRECTDRAWSURFACE, LPDIRECTDRAWSURFACE FAR * ) PURE;
  984.     STDMETHOD(EnumDisplayModes)( THIS_ DWORD, LPDDSURFACEDESC, LPVOID, LPDDENUMMODESCALLBACK ) PURE;
  985.     STDMETHOD(EnumSurfaces)(THIS_ DWORD, LPDDSURFACEDESC, LPVOID,LPDDENUMSURFACESCALLBACK ) PURE;
  986.     STDMETHOD(FlipToGDISurface)(THIS) PURE;
  987.     STDMETHOD(GetCaps)( THIS_ LPDDCAPS, LPDDCAPS) PURE;
  988.     STDMETHOD(GetDisplayMode)( THIS_ LPDDSURFACEDESC) PURE;
  989.     STDMETHOD(GetFourCCCodes)(THIS_  LPDWORD, LPDWORD ) PURE;
  990.     STDMETHOD(GetGDISurface)(THIS_ LPDIRECTDRAWSURFACE FAR *) PURE;
  991.     STDMETHOD(GetMonitorFrequency)(THIS_ LPDWORD) PURE;
  992.     STDMETHOD(GetScanLine)(THIS_ LPDWORD) PURE;
  993.     STDMETHOD(GetVerticalBlankStatus)(THIS_ LPBOOL ) PURE;
  994.     STDMETHOD(Initialize)(THIS_ GUID FAR *) PURE;
  995.     STDMETHOD(RestoreDisplayMode)(THIS) PURE;
  996.     STDMETHOD(SetCooperativeLevel)(THIS_ HWND, DWORD) PURE;
  997.     STDMETHOD(SetDisplayMode)(THIS_ DWORD, DWORD,DWORD) PURE;
  998.     STDMETHOD(WaitForVerticalBlank)(THIS_ DWORD, HANDLE ) PURE;
  999. };
  1000.  
  1001. #if !defined(__cplusplus) || defined(CINTERFACE)
  1002. #define IDirectDraw_QueryInterface(p, a, b)         (p)->lpVtbl->QueryInterface(p, a, b)
  1003. #define IDirectDraw_AddRef(p)                       (p)->lpVtbl->AddRef(p)
  1004. #define IDirectDraw_Release(p)                      (p)->lpVtbl->Release(p)
  1005. #define IDirectDraw_Compact(p)                      (p)->lpVtbl->Compact(p)
  1006. #define IDirectDraw_CreateClipper(p, a, b, c)       (p)->lpVtbl->CreateClipper(p, a, b, c)
  1007. #define IDirectDraw_CreatePalette(p, a, b, c, d)    (p)->lpVtbl->CreatePalette(p, a, b, c, d)
  1008. #define IDirectDraw_CreateSurface(p, a, b, c)       (p)->lpVtbl->CreateSurface(p, a, b, c)
  1009. #define IDirectDraw_DuplicateSurface(p, a, b)       (p)->lpVtbl->DuplicateSurface(p, a, b)
  1010. #define IDirectDraw_EnumDisplayModes(p, a, b, c, d) (p)->lpVtbl->EnumDisplayModes(p, a, b, c, d)
  1011. #define IDirectDraw_EnumSurfaces(p, a, b, c, d)     (p)->lpVtbl->EnumSurfaces(p, a, b, c, d)
  1012. #define IDirectDraw_FlipToGDISurface(p)             (p)->lpVtbl->FlipToGDISurface(p)
  1013. #define IDirectDraw_GetCaps(p, a, b)                (p)->lpVtbl->GetCaps(p, a, b)
  1014. #define IDirectDraw_GetDisplayMode(p, a)            (p)->lpVtbl->GetDisplayMode(p, a)
  1015. #define IDirectDraw_GetFourCCCodes(p, a, b)         (p)->lpVtbl->GetFourCCCodes(p, a, b)
  1016. #define IDirectDraw_GetGDISurface(p, a)             (p)->lpVtbl->GetGDISurface(p, a)
  1017. #define IDirectDraw_GetMonitorFrequency(p, a)       (p)->lpVtbl->GetMonitorFrequency(p, a)
  1018. #define IDirectDraw_GetScanLine(p, a)               (p)->lpVtbl->GetScanLine(p, a)
  1019. #define IDirectDraw_GetVerticalBlankStatus(p, a)    (p)->lpVtbl->GetVerticalBlankStatus(p, a)
  1020. #define IDirectDraw_Initialize(p, a)                (p)->lpVtbl->Initialize(p, a)
  1021. #define IDirectDraw_RestoreDisplayMode(p)           (p)->lpVtbl->RestoreDisplayMode(p)
  1022. #define IDirectDraw_SetCooperativeLevel(p, a, b)    (p)->lpVtbl->SetCooperativeLevel(p, a, b)
  1023. #define IDirectDraw_SetDisplayMode(p, a, b, c)      (p)->lpVtbl->SetDisplayMode(p, a, b, c)
  1024. #define IDirectDraw_WaitForVerticalBlank(p, a, b)   (p)->lpVtbl->WaitForVerticalBlank(p, a, b)
  1025. #else
  1026. #define IDirectDraw_QueryInterface(p, a, b)         (p)->QueryInterface(a, b)
  1027. #define IDirectDraw_AddRef(p)                       (p)->AddRef()
  1028. #define IDirectDraw_Release(p)                      (p)->Release()
  1029. #define IDirectDraw_Compact(p)                      (p)->Compact()
  1030. #define IDirectDraw_CreateClipper(p, a, b, c)       (p)->CreateClipper(a, b, c)
  1031. #define IDirectDraw_CreatePalette(p, a, b, c, d)    (p)->CreatePalette(a, b, c, d)
  1032. #define IDirectDraw_CreateSurface(p, a, b, c)       (p)->CreateSurface(a, b, c)
  1033. #define IDirectDraw_DuplicateSurface(p, a, b)       (p)->DuplicateSurface(a, b)
  1034. #define IDirectDraw_EnumDisplayModes(p, a, b, c, d) (p)->EnumDisplayModes(a, b, c, d)
  1035. #define IDirectDraw_EnumSurfaces(p, a, b, c, d)     (p)->EnumSurfaces(a, b, c, d)
  1036. #define IDirectDraw_FlipToGDISurface(p)             (p)->FlipToGDISurface()
  1037. #define IDirectDraw_GetCaps(p, a, b)                (p)->GetCaps(a, b)
  1038. #define IDirectDraw_GetDisplayMode(p, a)            (p)->GetDisplayMode(a)
  1039. #define IDirectDraw_GetFourCCCodes(p, a, b)         (p)->GetFourCCCodes(a, b)
  1040. #define IDirectDraw_GetGDISurface(p, a)             (p)->GetGDISurface(a)
  1041. #define IDirectDraw_GetMonitorFrequency(p, a)       (p)->GetMonitorFrequency(a)
  1042. #define IDirectDraw_GetScanLine(p, a)               (p)->GetScanLine(a)
  1043. #define IDirectDraw_GetVerticalBlankStatus(p, a)    (p)->GetVerticalBlankStatus(a)
  1044. #define IDirectDraw_Initialize(p, a)                (p)->Initialize(a)
  1045. #define IDirectDraw_RestoreDisplayMode(p)           (p)->RestoreDisplayMode()
  1046. #define IDirectDraw_SetCooperativeLevel(p, a, b)    (p)->SetCooperativeLevel(a, b)
  1047. #define IDirectDraw_SetDisplayMode(p, a, b, c)      (p)->SetDisplayMode(a, b, c)
  1048. #define IDirectDraw_WaitForVerticalBlank(p, a, b)   (p)->WaitForVerticalBlank(a, b)
  1049. #endif
  1050.  
  1051. #endif
  1052.  
  1053. #if defined( _WIN32 ) && !defined( _NO_COM )
  1054. #undef INTERFACE
  1055. #define INTERFACE IDirectDraw2
  1056. DECLARE_INTERFACE_( IDirectDraw2, IUnknown )
  1057. {
  1058.     /*** IUnknown methods ***/
  1059.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE;
  1060.     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
  1061.     STDMETHOD_(ULONG,Release) (THIS) PURE;
  1062.     /*** IDirectDraw methods ***/
  1063.     STDMETHOD(Compact)(THIS) PURE;
  1064.     STDMETHOD(CreateClipper)(THIS_ DWORD, LPDIRECTDRAWCLIPPER FAR*, IUnknown FAR * ) PURE;
  1065.     STDMETHOD(CreatePalette)(THIS_ DWORD, LPPALETTEENTRY, LPDIRECTDRAWPALETTE FAR*, IUnknown FAR * ) PURE;
  1066.     STDMETHOD(CreateSurface)(THIS_  LPDDSURFACEDESC, LPDIRECTDRAWSURFACE FAR *, IUnknown FAR *) PURE;
  1067.     STDMETHOD(DuplicateSurface)( THIS_ LPDIRECTDRAWSURFACE, LPDIRECTDRAWSURFACE FAR * ) PURE;
  1068.     STDMETHOD(EnumDisplayModes)( THIS_ DWORD, LPDDSURFACEDESC, LPVOID, LPDDENUMMODESCALLBACK ) PURE;
  1069.     STDMETHOD(EnumSurfaces)(THIS_ DWORD, LPDDSURFACEDESC, LPVOID,LPDDENUMSURFACESCALLBACK ) PURE;
  1070.     STDMETHOD(FlipToGDISurface)(THIS) PURE;
  1071.     STDMETHOD(GetCaps)( THIS_ LPDDCAPS, LPDDCAPS) PURE;
  1072.     STDMETHOD(GetDisplayMode)( THIS_ LPDDSURFACEDESC) PURE;
  1073.     STDMETHOD(GetFourCCCodes)(THIS_  LPDWORD, LPDWORD ) PURE;
  1074.     STDMETHOD(GetGDISurface)(THIS_ LPDIRECTDRAWSURFACE FAR *) PURE;
  1075.     STDMETHOD(GetMonitorFrequency)(THIS_ LPDWORD) PURE;
  1076.     STDMETHOD(GetScanLine)(THIS_ LPDWORD) PURE;
  1077.     STDMETHOD(GetVerticalBlankStatus)(THIS_ LPBOOL ) PURE;
  1078.     STDMETHOD(Initialize)(THIS_ GUID FAR *) PURE;
  1079.     STDMETHOD(RestoreDisplayMode)(THIS) PURE;
  1080.     STDMETHOD(SetCooperativeLevel)(THIS_ HWND, DWORD) PURE;
  1081.     STDMETHOD(SetDisplayMode)(THIS_ DWORD, DWORD,DWORD, DWORD, DWORD) PURE;
  1082.     STDMETHOD(WaitForVerticalBlank)(THIS_ DWORD, HANDLE ) PURE;
  1083.     /*** Added in the v2 interface ***/
  1084.     STDMETHOD(GetAvailableVidMem)(THIS_ LPDDSCAPS, LPDWORD, LPDWORD) PURE;
  1085. };
  1086. #if !defined(__cplusplus) || defined(CINTERFACE)
  1087. #define IDirectDraw2_QueryInterface(p, a, b)         (p)->lpVtbl->QueryInterface(p, a, b)
  1088. #define IDirectDraw2_AddRef(p)                       (p)->lpVtbl->AddRef(p)
  1089. #define IDirectDraw2_Release(p)                      (p)->lpVtbl->Release(p)
  1090. #define IDirectDraw2_Compact(p)                      (p)->lpVtbl->Compact(p)
  1091. #define IDirectDraw2_CreateClipper(p, a, b, c)       (p)->lpVtbl->CreateClipper(p, a, b, c)
  1092. #define IDirectDraw2_CreatePalette(p, a, b, c, d)    (p)->lpVtbl->CreatePalette(p, a, b, c, d)
  1093. #define IDirectDraw2_CreateSurface(p, a, b, c)       (p)->lpVtbl->CreateSurface(p, a, b, c)
  1094. #define IDirectDraw2_DuplicateSurface(p, a, b)       (p)->lpVtbl->DuplicateSurface(p, a, b)
  1095. #define IDirectDraw2_EnumDisplayModes(p, a, b, c, d) (p)->lpVtbl->EnumDisplayModes(p, a, b, c, d)
  1096. #define IDirectDraw2_EnumSurfaces(p, a, b, c, d)     (p)->lpVtbl->EnumSurfaces(p, a, b, c, d)
  1097. #define IDirectDraw2_FlipToGDISurface(p)             (p)->lpVtbl->FlipToGDISurface(p)
  1098. #define IDirectDraw2_GetCaps(p, a, b)                (p)->lpVtbl->GetCaps(p, a, b)
  1099. #define IDirectDraw2_GetDisplayMode(p, a)            (p)->lpVtbl->GetDisplayMode(p, a)
  1100. #define IDirectDraw2_GetFourCCCodes(p, a, b)         (p)->lpVtbl->GetFourCCCodes(p, a, b)
  1101. #define IDirectDraw2_GetGDISurface(p, a)             (p)->lpVtbl->GetGDISurface(p, a)
  1102. #define IDirectDraw2_GetMonitorFrequency(p, a)       (p)->lpVtbl->GetMonitorFrequency(p, a)
  1103. #define IDirectDraw2_GetScanLine(p, a)               (p)->lpVtbl->GetScanLine(p, a)
  1104. #define IDirectDraw2_GetVerticalBlankStatus(p, a)    (p)->lpVtbl->GetVerticalBlankStatus(p, a)
  1105. #define IDirectDraw2_Initialize(p, a)                (p)->lpVtbl->Initialize(p, a)
  1106. #define IDirectDraw2_RestoreDisplayMode(p)           (p)->lpVtbl->RestoreDisplayMode(p)
  1107. #define IDirectDraw2_SetCooperativeLevel(p, a, b)    (p)->lpVtbl->SetCooperativeLevel(p, a, b)
  1108. #define IDirectDraw2_SetDisplayMode(p, a, b, c, d, e) (p)->lpVtbl->SetDisplayMode(p, a, b, c, d, e)
  1109. #define IDirectDraw2_WaitForVerticalBlank(p, a, b)   (p)->lpVtbl->WaitForVerticalBlank(p, a, b)
  1110. #define IDirectDraw2_GetAvailableVidMem(p, a, b, c)  (p)->lpVtbl->GetAvailableVidMem(p, a, b, c)
  1111. #else
  1112. #define IDirectDraw2_QueryInterface(p, a, b)         (p)->QueryInterface(a, b)
  1113. #define IDirectDraw2_AddRef(p)                       (p)->AddRef()
  1114. #define IDirectDraw2_Release(p)                      (p)->Release()
  1115. #define IDirectDraw2_Compact(p)                      (p)->Compact()
  1116. #define IDirectDraw2_CreateClipper(p, a, b, c)       (p)->CreateClipper(a, b, c)
  1117. #define IDirectDraw2_CreatePalette(p, a, b, c, d)    (p)->CreatePalette(a, b, c, d)
  1118. #define IDirectDraw2_CreateSurface(p, a, b, c)       (p)->CreateSurface(a, b, c)
  1119. #define IDirectDraw2_DuplicateSurface(p, a, b)       (p)->DuplicateSurface(a, b)
  1120. #define IDirectDraw2_EnumDisplayModes(p, a, b, c, d) (p)->EnumDisplayModes(a, b, c, d)
  1121. #define IDirectDraw2_EnumSurfaces(p, a, b, c, d)     (p)->EnumSurfaces(a, b, c, d)
  1122. #define IDirectDraw2_FlipToGDISurface(p)             (p)->FlipToGDISurface()
  1123. #define IDirectDraw2_GetCaps(p, a, b)                (p)->GetCaps(a, b)
  1124. #define IDirectDraw2_GetDisplayMode(p, a)            (p)->GetDisplayMode(a)
  1125. #define IDirectDraw2_GetFourCCCodes(p, a, b)         (p)->GetFourCCCodes(a, b)
  1126. #define IDirectDraw2_GetGDISurface(p, a)             (p)->GetGDISurface(a)
  1127. #define IDirectDraw2_GetMonitorFrequency(p, a)       (p)->GetMonitorFrequency(a)
  1128. #define IDirectDraw2_GetScanLine(p, a)               (p)->GetScanLine(a)
  1129. #define IDirectDraw2_GetVerticalBlankStatus(p, a)    (p)->GetVerticalBlankStatus(a)
  1130. #define IDirectDraw2_Initialize(p, a)                (p)->Initialize(a)
  1131. #define IDirectDraw2_RestoreDisplayMode(p)           (p)->RestoreDisplayMode()
  1132. #define IDirectDraw2_SetCooperativeLevel(p, a, b)    (p)->SetCooperativeLevel(a, b)
  1133. #define IDirectDraw2_SetDisplayMode(p, a, b, c, d, e) (p)->SetDisplayMode(a, b, c, d, e)
  1134. #define IDirectDraw2_WaitForVerticalBlank(p, a, b)   (p)->WaitForVerticalBlank(a, b)
  1135. #define IDirectDraw2_GetAvailableVidMem(p, a, b, c)  (p)->GetAvailableVidMem(a, b, c)
  1136. #endif
  1137.  
  1138. #endif
  1139.  
  1140. #if defined( _WIN32 ) && !defined( _NO_COM )
  1141. #undef INTERFACE
  1142. #define INTERFACE IDirectDraw4
  1143. DECLARE_INTERFACE_( IDirectDraw4, IUnknown )
  1144. {
  1145.     /*** IUnknown methods ***/
  1146.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE;
  1147.     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
  1148.     STDMETHOD_(ULONG,Release) (THIS) PURE;
  1149.     /*** IDirectDraw methods ***/
  1150.     STDMETHOD(Compact)(THIS) PURE;
  1151.     STDMETHOD(CreateClipper)(THIS_ DWORD, LPDIRECTDRAWCLIPPER FAR*, IUnknown FAR * ) PURE;
  1152.     STDMETHOD(CreatePalette)(THIS_ DWORD, LPPALETTEENTRY, LPDIRECTDRAWPALETTE FAR*, IUnknown FAR * ) PURE;
  1153.     STDMETHOD(CreateSurface)(THIS_  LPDDSURFACEDESC2, LPDIRECTDRAWSURFACE4 FAR *, IUnknown FAR *) PURE;
  1154.     STDMETHOD(DuplicateSurface)( THIS_ LPDIRECTDRAWSURFACE4, LPDIRECTDRAWSURFACE4 FAR * ) PURE;
  1155.     STDMETHOD(EnumDisplayModes)( THIS_ DWORD, LPDDSURFACEDESC2, LPVOID, LPDDENUMMODESCALLBACK2 ) PURE;
  1156.     STDMETHOD(EnumSurfaces)(THIS_ DWORD, LPDDSURFACEDESC2, LPVOID,LPDDENUMSURFACESCALLBACK2 ) PURE;
  1157.     STDMETHOD(FlipToGDISurface)(THIS) PURE;
  1158.     STDMETHOD(GetCaps)( THIS_ LPDDCAPS, LPDDCAPS) PURE;
  1159.     STDMETHOD(GetDisplayMode)( THIS_ LPDDSURFACEDESC2) PURE;
  1160.     STDMETHOD(GetFourCCCodes)(THIS_  LPDWORD, LPDWORD ) PURE;
  1161.     STDMETHOD(GetGDISurface)(THIS_ LPDIRECTDRAWSURFACE4 FAR *) PURE;
  1162.     STDMETHOD(GetMonitorFrequency)(THIS_ LPDWORD) PURE;
  1163.     STDMETHOD(GetScanLine)(THIS_ LPDWORD) PURE;
  1164.     STDMETHOD(GetVerticalBlankStatus)(THIS_ LPBOOL ) PURE;
  1165.     STDMETHOD(Initialize)(THIS_ GUID FAR *) PURE;
  1166.     STDMETHOD(RestoreDisplayMode)(THIS) PURE;
  1167.     STDMETHOD(SetCooperativeLevel)(THIS_ HWND, DWORD) PURE;
  1168.     STDMETHOD(SetDisplayMode)(THIS_ DWORD, DWORD,DWORD, DWORD, DWORD) PURE;
  1169.     STDMETHOD(WaitForVerticalBlank)(THIS_ DWORD, HANDLE ) PURE;
  1170.     /*** Added in the v2 interface ***/
  1171.     STDMETHOD(GetAvailableVidMem)(THIS_ LPDDSCAPS2, LPDWORD, LPDWORD) PURE;
  1172.     /*** Added in the V4 Interface ***/
  1173.     STDMETHOD(GetSurfaceFromDC) (THIS_ HDC, LPDIRECTDRAWSURFACE4 *) PURE;
  1174.     STDMETHOD(RestoreAllSurfaces)(THIS) PURE;
  1175.     STDMETHOD(TestCooperativeLevel)(THIS) PURE;
  1176.     STDMETHOD(GetDeviceIdentifier)(THIS_ LPDDDEVICEIDENTIFIER, DWORD ) PURE;
  1177. };
  1178. #if !defined(__cplusplus) || defined(CINTERFACE)
  1179. #define IDirectDraw4_QueryInterface(p, a, b)         (p)->lpVtbl->QueryInterface(p, a, b)
  1180. #define IDirectDraw4_AddRef(p)                       (p)->lpVtbl->AddRef(p)
  1181. #define IDirectDraw4_Release(p)                      (p)->lpVtbl->Release(p)
  1182. #define IDirectDraw4_Compact(p)                      (p)->lpVtbl->Compact(p)
  1183. #define IDirectDraw4_CreateClipper(p, a, b, c)       (p)->lpVtbl->CreateClipper(p, a, b, c)
  1184. #define IDirectDraw4_CreatePalette(p, a, b, c, d)    (p)->lpVtbl->CreatePalette(p, a, b, c, d)
  1185. #define IDirectDraw4_CreateSurface(p, a, b, c)       (p)->lpVtbl->CreateSurface(p, a, b, c)
  1186. #define IDirectDraw4_DuplicateSurface(p, a, b)       (p)->lpVtbl->DuplicateSurface(p, a, b)
  1187. #define IDirectDraw4_EnumDisplayModes(p, a, b, c, d) (p)->lpVtbl->EnumDisplayModes(p, a, b, c, d)
  1188. #define IDirectDraw4_EnumSurfaces(p, a, b, c, d)     (p)->lpVtbl->EnumSurfaces(p, a, b, c, d)
  1189. #define IDirectDraw4_FlipToGDISurface(p)             (p)->lpVtbl->FlipToGDISurface(p)
  1190. #define IDirectDraw4_GetCaps(p, a, b)                (p)->lpVtbl->GetCaps(p, a, b)
  1191. #define IDirectDraw4_GetDisplayMode(p, a)            (p)->lpVtbl->GetDisplayMode(p, a)
  1192. #define IDirectDraw4_GetFourCCCodes(p, a, b)         (p)->lpVtbl->GetFourCCCodes(p, a, b)
  1193. #define IDirectDraw4_GetGDISurface(p, a)             (p)->lpVtbl->GetGDISurface(p, a)
  1194. #define IDirectDraw4_GetMonitorFrequency(p, a)       (p)->lpVtbl->GetMonitorFrequency(p, a)
  1195. #define IDirectDraw4_GetScanLine(p, a)               (p)->lpVtbl->GetScanLine(p, a)
  1196. #define IDirectDraw4_GetVerticalBlankStatus(p, a)    (p)->lpVtbl->GetVerticalBlankStatus(p, a)
  1197. #define IDirectDraw4_Initialize(p, a)                (p)->lpVtbl->Initialize(p, a)
  1198. #define IDirectDraw4_RestoreDisplayMode(p)           (p)->lpVtbl->RestoreDisplayMode(p)
  1199. #define IDirectDraw4_SetCooperativeLevel(p, a, b)    (p)->lpVtbl->SetCooperativeLevel(p, a, b)
  1200. #define IDirectDraw4_SetDisplayMode(p, a, b, c, d, e) (p)->lpVtbl->SetDisplayMode(p, a, b, c, d, e)
  1201. #define IDirectDraw4_WaitForVerticalBlank(p, a, b)   (p)->lpVtbl->WaitForVerticalBlank(p, a, b)
  1202. #define IDirectDraw4_GetAvailableVidMem(p, a, b, c)  (p)->lpVtbl->GetAvailableVidMem(p, a, b, c)
  1203. #define IDirectDraw4_GetSurfaceFromDC(p, a, b)       (p)->lpVtbl->GetSurfaceFromDC(p, a, b)
  1204. #define IDirectDraw4_RestoreAllSurfaces(p)           (p)->lpVtbl->RestoreAllSurfaces(p)
  1205. #define IDirectDraw4_TestCooperativeLevel(p)         (p)->lpVtbl->TestCooperativeLevel(p)
  1206. #define IDirectDraw4_GetDeviceIdentifier(p,a,b)      (p)->lpVtbl->GetDeviceIdentifier(p,a,b)
  1207. #else
  1208. #define IDirectDraw4_QueryInterface(p, a, b)         (p)->QueryInterface(a, b)
  1209. #define IDirectDraw4_AddRef(p)                       (p)->AddRef()
  1210. #define IDirectDraw4_Release(p)                      (p)->Release()
  1211. #define IDirectDraw4_Compact(p)                      (p)->Compact()
  1212. #define IDirectDraw4_CreateClipper(p, a, b, c)       (p)->CreateClipper(a, b, c)
  1213. #define IDirectDraw4_CreatePalette(p, a, b, c, d)    (p)->CreatePalette(a, b, c, d)
  1214. #define IDirectDraw4_CreateSurface(p, a, b, c)       (p)->CreateSurface(a, b, c)
  1215. #define IDirectDraw4_DuplicateSurface(p, a, b)       (p)->DuplicateSurface(a, b)
  1216. #define IDirectDraw4_EnumDisplayModes(p, a, b, c, d) (p)->EnumDisplayModes(a, b, c, d)
  1217. #define IDirectDraw4_EnumSurfaces(p, a, b, c, d)     (p)->EnumSurfaces(a, b, c, d)
  1218. #define IDirectDraw4_FlipToGDISurface(p)             (p)->FlipToGDISurface()
  1219. #define IDirectDraw4_GetCaps(p, a, b)                (p)->GetCaps(a, b)
  1220. #define IDirectDraw4_GetDisplayMode(p, a)            (p)->GetDisplayMode(a)
  1221. #define IDirectDraw4_GetFourCCCodes(p, a, b)         (p)->GetFourCCCodes(a, b)
  1222. #define IDirectDraw4_GetGDISurface(p, a)             (p)->GetGDISurface(a)
  1223. #define IDirectDraw4_GetMonitorFrequency(p, a)       (p)->GetMonitorFrequency(a)
  1224. #define IDirectDraw4_GetScanLine(p, a)               (p)->GetScanLine(a)
  1225. #define IDirectDraw4_GetVerticalBlankStatus(p, a)    (p)->GetVerticalBlankStatus(a)
  1226. #define IDirectDraw4_Initialize(p, a)                (p)->Initialize(a)
  1227. #define IDirectDraw4_RestoreDisplayMode(p)           (p)->RestoreDisplayMode()
  1228. #define IDirectDraw4_SetCooperativeLevel(p, a, b)    (p)->SetCooperativeLevel(a, b)
  1229. #define IDirectDraw4_SetDisplayMode(p, a, b, c, d, e) (p)->SetDisplayMode(a, b, c, d, e)
  1230. #define IDirectDraw4_WaitForVerticalBlank(p, a, b)   (p)->WaitForVerticalBlank(a, b)
  1231. #define IDirectDraw4_GetAvailableVidMem(p, a, b, c)  (p)->GetAvailableVidMem(a, b, c)
  1232. #define IDirectDraw4_GetSurfaceFromDC(p, a, b)       (p)->GetSurfaceFromDC(a, b)
  1233. #define IDirectDraw4_RestoreAllSurfaces(p)           (p)->RestoreAllSurfaces()
  1234. #define IDirectDraw4_TestCooperativeLevel(p)         (p)->TestCooperativeLevel()
  1235. #define IDirectDraw4_GetDeviceIdentifier(p,a,b)      (p)->GetDeviceIdentifier(a,b)
  1236. #endif
  1237.  
  1238. #endif
  1239.  
  1240. #if defined( _WIN32 ) && !defined( _NO_COM )
  1241. #undef INTERFACE
  1242. #define INTERFACE IDirectDraw7
  1243. DECLARE_INTERFACE_( IDirectDraw7, IUnknown )
  1244. {
  1245.     /*** IUnknown methods ***/
  1246.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE;
  1247.     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
  1248.     STDMETHOD_(ULONG,Release) (THIS) PURE;
  1249.     /*** IDirectDraw methods ***/
  1250.     STDMETHOD(Compact)(THIS) PURE;
  1251.     STDMETHOD(CreateClipper)(THIS_ DWORD, LPDIRECTDRAWCLIPPER FAR*, IUnknown FAR * ) PURE;
  1252.     STDMETHOD(CreatePalette)(THIS_ DWORD, LPPALETTEENTRY, LPDIRECTDRAWPALETTE FAR*, IUnknown FAR * ) PURE;
  1253.     STDMETHOD(CreateSurface)(THIS_  LPDDSURFACEDESC2, LPDIRECTDRAWSURFACE7 FAR *, IUnknown FAR *) PURE;
  1254.     STDMETHOD(DuplicateSurface)( THIS_ LPDIRECTDRAWSURFACE7, LPDIRECTDRAWSURFACE7 FAR * ) PURE;
  1255.     STDMETHOD(EnumDisplayModes)( THIS_ DWORD, LPDDSURFACEDESC2, LPVOID, LPDDENUMMODESCALLBACK2 ) PURE;
  1256.     STDMETHOD(EnumSurfaces)(THIS_ DWORD, LPDDSURFACEDESC2, LPVOID,LPDDENUMSURFACESCALLBACK7 ) PURE;
  1257.     STDMETHOD(FlipToGDISurface)(THIS) PURE;
  1258.     STDMETHOD(GetCaps)( THIS_ LPDDCAPS, LPDDCAPS) PURE;
  1259.     STDMETHOD(GetDisplayMode)( THIS_ LPDDSURFACEDESC2) PURE;
  1260.     STDMETHOD(GetFourCCCodes)(THIS_  LPDWORD, LPDWORD ) PURE;
  1261.     STDMETHOD(GetGDISurface)(THIS_ LPDIRECTDRAWSURFACE7 FAR *) PURE;
  1262.     STDMETHOD(GetMonitorFrequency)(THIS_ LPDWORD) PURE;
  1263.     STDMETHOD(GetScanLine)(THIS_ LPDWORD) PURE;
  1264.     STDMETHOD(GetVerticalBlankStatus)(THIS_ LPBOOL ) PURE;
  1265.     STDMETHOD(Initialize)(THIS_ GUID FAR *) PURE;
  1266.     STDMETHOD(RestoreDisplayMode)(THIS) PURE;
  1267.     STDMETHOD(SetCooperativeLevel)(THIS_ HWND, DWORD) PURE;
  1268.     STDMETHOD(SetDisplayMode)(THIS_ DWORD, DWORD,DWORD, DWORD, DWORD) PURE;
  1269.     STDMETHOD(WaitForVerticalBlank)(THIS_ DWORD, HANDLE ) PURE;
  1270.     /*** Added in the v2 interface ***/
  1271.     STDMETHOD(GetAvailableVidMem)(THIS_ LPDDSCAPS2, LPDWORD, LPDWORD) PURE;
  1272.     /*** Added in the V4 Interface ***/
  1273.     STDMETHOD(GetSurfaceFromDC) (THIS_ HDC, LPDIRECTDRAWSURFACE7 *) PURE;
  1274.     STDMETHOD(RestoreAllSurfaces)(THIS) PURE;
  1275.     STDMETHOD(TestCooperativeLevel)(THIS) PURE;
  1276.     STDMETHOD(GetDeviceIdentifier)(THIS_ LPDDDEVICEIDENTIFIER2, DWORD ) PURE;
  1277.     STDMETHOD(StartModeTest)(THIS_ LPSIZE, DWORD, DWORD ) PURE;
  1278.     STDMETHOD(EvaluateMode)(THIS_ DWORD, DWORD * ) PURE;
  1279. };
  1280. #if !defined(__cplusplus) || defined(CINTERFACE)
  1281. #define IDirectDraw7_QueryInterface(p, a, b)         (p)->lpVtbl->QueryInterface(p, a, b)
  1282. #define IDirectDraw7_AddRef(p)                       (p)->lpVtbl->AddRef(p)
  1283. #define IDirectDraw7_Release(p)                      (p)->lpVtbl->Release(p)
  1284. #define IDirectDraw7_Compact(p)                      (p)->lpVtbl->Compact(p)
  1285. #define IDirectDraw7_CreateClipper(p, a, b, c)       (p)->lpVtbl->CreateClipper(p, a, b, c)
  1286. #define IDirectDraw7_CreatePalette(p, a, b, c, d)    (p)->lpVtbl->CreatePalette(p, a, b, c, d)
  1287. #define IDirectDraw7_CreateSurface(p, a, b, c)       (p)->lpVtbl->CreateSurface(p, a, b, c)
  1288. #define IDirectDraw7_DuplicateSurface(p, a, b)       (p)->lpVtbl->DuplicateSurface(p, a, b)
  1289. #define IDirectDraw7_EnumDisplayModes(p, a, b, c, d) (p)->lpVtbl->EnumDisplayModes(p, a, b, c, d)
  1290. #define IDirectDraw7_EnumSurfaces(p, a, b, c, d)     (p)->lpVtbl->EnumSurfaces(p, a, b, c, d)
  1291. #define IDirectDraw7_FlipToGDISurface(p)             (p)->lpVtbl->FlipToGDISurface(p)
  1292. #define IDirectDraw7_GetCaps(p, a, b)                (p)->lpVtbl->GetCaps(p, a, b)
  1293. #define IDirectDraw7_GetDisplayMode(p, a)            (p)->lpVtbl->GetDisplayMode(p, a)
  1294. #define IDirectDraw7_GetFourCCCodes(p, a, b)         (p)->lpVtbl->GetFourCCCodes(p, a, b)
  1295. #define IDirectDraw7_GetGDISurface(p, a)             (p)->lpVtbl->GetGDISurface(p, a)
  1296. #define IDirectDraw7_GetMonitorFrequency(p, a)       (p)->lpVtbl->GetMonitorFrequency(p, a)
  1297. #define IDirectDraw7_GetScanLine(p, a)               (p)->lpVtbl->GetScanLine(p, a)
  1298. #define IDirectDraw7_GetVerticalBlankStatus(p, a)    (p)->lpVtbl->GetVerticalBlankStatus(p, a)
  1299. #define IDirectDraw7_Initialize(p, a)                (p)->lpVtbl->Initialize(p, a)
  1300. #define IDirectDraw7_RestoreDisplayMode(p)           (p)->lpVtbl->RestoreDisplayMode(p)
  1301. #define IDirectDraw7_SetCooperativeLevel(p, a, b)    (p)->lpVtbl->SetCooperativeLevel(p, a, b)
  1302. #define IDirectDraw7_SetDisplayMode(p, a, b, c, d, e) (p)->lpVtbl->SetDisplayMode(p, a, b, c, d, e)
  1303. #define IDirectDraw7_WaitForVerticalBlank(p, a, b)   (p)->lpVtbl->WaitForVerticalBlank(p, a, b)
  1304. #define IDirectDraw7_GetAvailableVidMem(p, a, b, c)  (p)->lpVtbl->GetAvailableVidMem(p, a, b, c)
  1305. #define IDirectDraw7_GetSurfaceFromDC(p, a, b)       (p)->lpVtbl->GetSurfaceFromDC(p, a, b)
  1306. #define IDirectDraw7_RestoreAllSurfaces(p)           (p)->lpVtbl->RestoreAllSurfaces(p)
  1307. #define IDirectDraw7_TestCooperativeLevel(p)         (p)->lpVtbl->TestCooperativeLevel(p)
  1308. #define IDirectDraw7_GetDeviceIdentifier(p,a,b)      (p)->lpVtbl->GetDeviceIdentifier(p,a,b)
  1309. #define IDirectDraw7_StartModeTest(p,a,b,c)        (p)->lpVtbl->StartModeTest(p,a,b,c)
  1310. #define IDirectDraw7_EvaluateMode(p,a,b)           (p)->lpVtbl->EvaluateMode(p,a,b)
  1311. #else
  1312. #define IDirectDraw7_QueryInterface(p, a, b)         (p)->QueryInterface(a, b)
  1313. #define IDirectDraw7_AddRef(p)                       (p)->AddRef()
  1314. #define IDirectDraw7_Release(p)                      (p)->Release()
  1315. #define IDirectDraw7_Compact(p)                      (p)->Compact()
  1316. #define IDirectDraw7_CreateClipper(p, a, b, c)       (p)->CreateClipper(a, b, c)
  1317. #define IDirectDraw7_CreatePalette(p, a, b, c, d)    (p)->CreatePalette(a, b, c, d)
  1318. #define IDirectDraw7_CreateSurface(p, a, b, c)       (p)->CreateSurface(a, b, c)
  1319. #define IDirectDraw7_DuplicateSurface(p, a, b)       (p)->DuplicateSurface(a, b)
  1320. #define IDirectDraw7_EnumDisplayModes(p, a, b, c, d) (p)->EnumDisplayModes(a, b, c, d)
  1321. #define IDirectDraw7_EnumSurfaces(p, a, b, c, d)     (p)->EnumSurfaces(a, b, c, d)
  1322. #define IDirectDraw7_FlipToGDISurface(p)             (p)->FlipToGDISurface()
  1323. #define IDirectDraw7_GetCaps(p, a, b)                (p)->GetCaps(a, b)
  1324. #define IDirectDraw7_GetDisplayMode(p, a)            (p)->GetDisplayMode(a)
  1325. #define IDirectDraw7_GetFourCCCodes(p, a, b)         (p)->GetFourCCCodes(a, b)
  1326. #define IDirectDraw7_GetGDISurface(p, a)             (p)->GetGDISurface(a)
  1327. #define IDirectDraw7_GetMonitorFrequency(p, a)       (p)->GetMonitorFrequency(a)
  1328. #define IDirectDraw7_GetScanLine(p, a)               (p)->GetScanLine(a)
  1329. #define IDirectDraw7_GetVerticalBlankStatus(p, a)    (p)->GetVerticalBlankStatus(a)
  1330. #define IDirectDraw7_Initialize(p, a)                (p)->Initialize(a)
  1331. #define IDirectDraw7_RestoreDisplayMode(p)           (p)->RestoreDisplayMode()
  1332. #define IDirectDraw7_SetCooperativeLevel(p, a, b)    (p)->SetCooperativeLevel(a, b)
  1333. #define IDirectDraw7_SetDisplayMode(p, a, b, c, d, e) (p)->SetDisplayMode(a, b, c, d, e)
  1334. #define IDirectDraw7_WaitForVerticalBlank(p, a, b)   (p)->WaitForVerticalBlank(a, b)
  1335. #define IDirectDraw7_GetAvailableVidMem(p, a, b, c)  (p)->GetAvailableVidMem(a, b, c)
  1336. #define IDirectDraw7_GetSurfaceFromDC(p, a, b)       (p)->GetSurfaceFromDC(a, b)
  1337. #define IDirectDraw7_RestoreAllSurfaces(p)           (p)->RestoreAllSurfaces()
  1338. #define IDirectDraw7_TestCooperativeLevel(p)         (p)->TestCooperativeLevel()
  1339. #define IDirectDraw7_GetDeviceIdentifier(p,a,b)      (p)->GetDeviceIdentifier(a,b)
  1340. #define IDirectDraw7_StartModeTest(p,a,b,c)        (p)->lpVtbl->StartModeTest(a,b,c)
  1341. #define IDirectDraw7_EvaluateMode(p,a,b)           (p)->lpVtbl->EvaluateMode(a,b)
  1342. #endif
  1343.  
  1344. #endif
  1345.  
  1346.  
  1347. /*
  1348.  * IDirectDrawPalette
  1349.  */
  1350. #if defined( _WIN32 ) && !defined( _NO_COM )
  1351. #undef INTERFACE
  1352. #define INTERFACE IDirectDrawPalette
  1353. DECLARE_INTERFACE_( IDirectDrawPalette, IUnknown )
  1354. {
  1355.     /*** IUnknown methods ***/
  1356.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE;
  1357.     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
  1358.     STDMETHOD_(ULONG,Release) (THIS) PURE;
  1359.     /*** IDirectDrawPalette methods ***/
  1360.     STDMETHOD(GetCaps)(THIS_ LPDWORD) PURE;
  1361.     STDMETHOD(GetEntries)(THIS_ DWORD,DWORD,DWORD,LPPALETTEENTRY) PURE;
  1362.     STDMETHOD(Initialize)(THIS_ LPDIRECTDRAW, DWORD, LPPALETTEENTRY) PURE;
  1363.     STDMETHOD(SetEntries)(THIS_ DWORD,DWORD,DWORD,LPPALETTEENTRY) PURE;
  1364. };
  1365.  
  1366. #if !defined(__cplusplus) || defined(CINTERFACE)
  1367. #define IDirectDrawPalette_QueryInterface(p, a, b)      (p)->lpVtbl->QueryInterface(p, a, b)
  1368. #define IDirectDrawPalette_AddRef(p)                    (p)->lpVtbl->AddRef(p)
  1369. #define IDirectDrawPalette_Release(p)                   (p)->lpVtbl->Release(p)
  1370. #define IDirectDrawPalette_GetCaps(p, a)                (p)->lpVtbl->GetCaps(p, a)
  1371. #define IDirectDrawPalette_GetEntries(p, a, b, c, d)    (p)->lpVtbl->GetEntries(p, a, b, c, d)
  1372. #define IDirectDrawPalette_Initialize(p, a, b, c)       (p)->lpVtbl->Initialize(p, a, b, c)
  1373. #define IDirectDrawPalette_SetEntries(p, a, b, c, d)    (p)->lpVtbl->SetEntries(p, a, b, c, d)
  1374. #else
  1375. #define IDirectDrawPalette_QueryInterface(p, a, b)      (p)->QueryInterface(a, b)
  1376. #define IDirectDrawPalette_AddRef(p)                    (p)->AddRef()
  1377. #define IDirectDrawPalette_Release(p)                   (p)->Release()
  1378. #define IDirectDrawPalette_GetCaps(p, a)                (p)->GetCaps(a)
  1379. #define IDirectDrawPalette_GetEntries(p, a, b, c, d)    (p)->GetEntries(a, b, c, d)
  1380. #define IDirectDrawPalette_Initialize(p, a, b, c)       (p)->Initialize(a, b, c)
  1381. #define IDirectDrawPalette_SetEntries(p, a, b, c, d)    (p)->SetEntries(a, b, c, d)
  1382. #endif
  1383.  
  1384. #endif
  1385.  
  1386.  
  1387. /*
  1388.  * IDirectDrawClipper
  1389.  */
  1390. #if defined( _WIN32 ) && !defined( _NO_COM )
  1391. #undef INTERFACE
  1392. #define INTERFACE IDirectDrawClipper
  1393. DECLARE_INTERFACE_( IDirectDrawClipper, IUnknown )
  1394. {
  1395.     /*** IUnknown methods ***/
  1396.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE;
  1397.     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
  1398.     STDMETHOD_(ULONG,Release) (THIS) PURE;
  1399.     /*** IDirectDrawClipper methods ***/
  1400.     STDMETHOD(GetClipList)(THIS_ LPRECT, LPRGNDATA, LPDWORD) PURE;
  1401.     STDMETHOD(GetHWnd)(THIS_ HWND FAR *) PURE;
  1402.     STDMETHOD(Initialize)(THIS_ LPDIRECTDRAW, DWORD) PURE;
  1403.     STDMETHOD(IsClipListChanged)(THIS_ BOOL FAR *) PURE;
  1404.     STDMETHOD(SetClipList)(THIS_ LPRGNDATA,DWORD) PURE;
  1405.     STDMETHOD(SetHWnd)(THIS_ DWORD, HWND ) PURE;
  1406. };
  1407.  
  1408. #if !defined(__cplusplus) || defined(CINTERFACE)
  1409. #define IDirectDrawClipper_QueryInterface(p, a, b)  (p)->lpVtbl->QueryInterface(p, a, b)
  1410. #define IDirectDrawClipper_AddRef(p)                (p)->lpVtbl->AddRef(p)
  1411. #define IDirectDrawClipper_Release(p)               (p)->lpVtbl->Release(p)
  1412. #define IDirectDrawClipper_GetClipList(p, a, b, c)  (p)->lpVtbl->GetClipList(p, a, b, c)
  1413. #define IDirectDrawClipper_GetHWnd(p, a)            (p)->lpVtbl->GetHWnd(p, a)
  1414. #define IDirectDrawClipper_Initialize(p, a, b)      (p)->lpVtbl->Initialize(p, a, b)
  1415. #define IDirectDrawClipper_IsClipListChanged(p, a)  (p)->lpVtbl->IsClipListChanged(p, a)
  1416. #define IDirectDrawClipper_SetClipList(p, a, b)     (p)->lpVtbl->SetClipList(p, a, b)
  1417. #define IDirectDrawClipper_SetHWnd(p, a, b)         (p)->lpVtbl->SetHWnd(p, a, b)
  1418. #else
  1419. #define IDirectDrawClipper_QueryInterface(p, a, b)  (p)->QueryInterface(a, b)
  1420. #define IDirectDrawClipper_AddRef(p)                (p)->AddRef()
  1421. #define IDirectDrawClipper_Release(p)               (p)->Release()
  1422. #define IDirectDrawClipper_GetClipList(p, a, b, c)  (p)->GetClipList(a, b, c)
  1423. #define IDirectDrawClipper_GetHWnd(p, a)            (p)->GetHWnd(a)
  1424. #define IDirectDrawClipper_Initialize(p, a, b)      (p)->Initialize(a, b)
  1425. #define IDirectDrawClipper_IsClipListChanged(p, a)  (p)->IsClipListChanged(a)
  1426. #define IDirectDrawClipper_SetClipList(p, a, b)     (p)->SetClipList(a, b)
  1427. #define IDirectDrawClipper_SetHWnd(p, a, b)         (p)->SetHWnd(a, b)
  1428. #endif
  1429.  
  1430. #endif
  1431.  
  1432. /*
  1433.  * IDirectDrawSurface and related interfaces
  1434.  */
  1435. #if defined( _WIN32 ) && !defined( _NO_COM )
  1436. #undef INTERFACE
  1437. #define INTERFACE IDirectDrawSurface
  1438. DECLARE_INTERFACE_( IDirectDrawSurface, IUnknown )
  1439. {
  1440.     /*** IUnknown methods ***/
  1441.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE;
  1442.     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
  1443.     STDMETHOD_(ULONG,Release) (THIS) PURE;
  1444.     /*** IDirectDrawSurface methods ***/
  1445.     STDMETHOD(AddAttachedSurface)(THIS_ LPDIRECTDRAWSURFACE) PURE;
  1446.     STDMETHOD(AddOverlayDirtyRect)(THIS_ LPRECT) PURE;
  1447.     STDMETHOD(Blt)(THIS_ LPRECT,LPDIRECTDRAWSURFACE, LPRECT,DWORD, LPDDBLTFX) PURE;
  1448.     STDMETHOD(BltBatch)(THIS_ LPDDBLTBATCH, DWORD, DWORD ) PURE;
  1449.     STDMETHOD(BltFast)(THIS_ DWORD,DWORD,LPDIRECTDRAWSURFACE, LPRECT,DWORD) PURE;
  1450.     STDMETHOD(DeleteAttachedSurface)(THIS_ DWORD,LPDIRECTDRAWSURFACE) PURE;
  1451.     STDMETHOD(EnumAttachedSurfaces)(THIS_ LPVOID,LPDDENUMSURFACESCALLBACK) PURE;
  1452.     STDMETHOD(EnumOverlayZOrders)(THIS_ DWORD,LPVOID,LPDDENUMSURFACESCALLBACK) PURE;
  1453.     STDMETHOD(Flip)(THIS_ LPDIRECTDRAWSURFACE, DWORD) PURE;
  1454.     STDMETHOD(GetAttachedSurface)(THIS_ LPDDSCAPS, LPDIRECTDRAWSURFACE FAR *) PURE;
  1455.     STDMETHOD(GetBltStatus)(THIS_ DWORD) PURE;
  1456.     STDMETHOD(GetCaps)(THIS_ LPDDSCAPS) PURE;
  1457.     STDMETHOD(GetClipper)(THIS_ LPDIRECTDRAWCLIPPER FAR*) PURE;
  1458.     STDMETHOD(GetColorKey)(THIS_ DWORD, LPDDCOLORKEY) PURE;
  1459.     STDMETHOD(GetDC)(THIS_ HDC FAR *) PURE;
  1460.     STDMETHOD(GetFlipStatus)(THIS_ DWORD) PURE;
  1461.     STDMETHOD(GetOverlayPosition)(THIS_ LPLONG, LPLONG ) PURE;
  1462.     STDMETHOD(GetPalette)(THIS_ LPDIRECTDRAWPALETTE FAR*) PURE;
  1463.     STDMETHOD(GetPixelFormat)(THIS_ LPDDPIXELFORMAT) PURE;
  1464.     STDMETHOD(GetSurfaceDesc)(THIS_ LPDDSURFACEDESC) PURE;
  1465.     STDMETHOD(Initialize)(THIS_ LPDIRECTDRAW, LPDDSURFACEDESC) PURE;
  1466.     STDMETHOD(IsLost)(THIS) PURE;
  1467.     STDMETHOD(Lock)(THIS_ LPRECT,LPDDSURFACEDESC,DWORD,HANDLE) PURE;
  1468.     STDMETHOD(ReleaseDC)(THIS_ HDC) PURE;
  1469.     STDMETHOD(Restore)(THIS) PURE;
  1470.     STDMETHOD(SetClipper)(THIS_ LPDIRECTDRAWCLIPPER) PURE;
  1471.     STDMETHOD(SetColorKey)(THIS_ DWORD, LPDDCOLORKEY) PURE;
  1472.     STDMETHOD(SetOverlayPosition)(THIS_ LONG, LONG ) PURE;
  1473.     STDMETHOD(SetPalette)(THIS_ LPDIRECTDRAWPALETTE) PURE;
  1474.     STDMETHOD(Unlock)(THIS_ LPVOID) PURE;
  1475.     STDMETHOD(UpdateOverlay)(THIS_ LPRECT, LPDIRECTDRAWSURFACE,LPRECT,DWORD, LPDDOVERLAYFX) PURE;
  1476.     STDMETHOD(UpdateOverlayDisplay)(THIS_ DWORD) PURE;
  1477.     STDMETHOD(UpdateOverlayZOrder)(THIS_ DWORD, LPDIRECTDRAWSURFACE) PURE;
  1478. };
  1479.  
  1480. #if !defined(__cplusplus) || defined(CINTERFACE)
  1481. #define IDirectDrawSurface_QueryInterface(p,a,b)        (p)->lpVtbl->QueryInterface(p,a,b)
  1482. #define IDirectDrawSurface_AddRef(p)                    (p)->lpVtbl->AddRef(p)
  1483. #define IDirectDrawSurface_Release(p)                   (p)->lpVtbl->Release(p)
  1484. #define IDirectDrawSurface_AddAttachedSurface(p,a)      (p)->lpVtbl->AddAttachedSurface(p,a)
  1485. #define IDirectDrawSurface_AddOverlayDirtyRect(p,a)     (p)->lpVtbl->AddOverlayDirtyRect(p,a)
  1486. #define IDirectDrawSurface_Blt(p,a,b,c,d,e)             (p)->lpVtbl->Blt(p,a,b,c,d,e)
  1487. #define IDirectDrawSurface_BltBatch(p,a,b,c)            (p)->lpVtbl->BltBatch(p,a,b,c)
  1488. #define IDirectDrawSurface_BltFast(p,a,b,c,d,e)         (p)->lpVtbl->BltFast(p,a,b,c,d,e)
  1489. #define IDirectDrawSurface_DeleteAttachedSurface(p,a,b) (p)->lpVtbl->DeleteAttachedSurface(p,a,b)
  1490. #define IDirectDrawSurface_EnumAttachedSurfaces(p,a,b)  (p)->lpVtbl->EnumAttachedSurfaces(p,a,b)
  1491. #define IDirectDrawSurface_EnumOverlayZOrders(p,a,b,c)  (p)->lpVtbl->EnumOverlayZOrders(p,a,b,c)
  1492. #define IDirectDrawSurface_Flip(p,a,b)                  (p)->lpVtbl->Flip(p,a,b)
  1493. #define IDirectDrawSurface_GetAttachedSurface(p,a,b)    (p)->lpVtbl->GetAttachedSurface(p,a,b)
  1494. #define IDirectDrawSurface_GetBltStatus(p,a)            (p)->lpVtbl->GetBltStatus(p,a)
  1495. #define IDirectDrawSurface_GetCaps(p,b)                 (p)->lpVtbl->GetCaps(p,b)
  1496. #define IDirectDrawSurface_GetClipper(p,a)              (p)->lpVtbl->GetClipper(p,a)
  1497. #define IDirectDrawSurface_GetColorKey(p,a,b)           (p)->lpVtbl->GetColorKey(p,a,b)
  1498. #define IDirectDrawSurface_GetDC(p,a)                   (p)->lpVtbl->GetDC(p,a)
  1499. #define IDirectDrawSurface_GetFlipStatus(p,a)           (p)->lpVtbl->GetFlipStatus(p,a)
  1500. #define IDirectDrawSurface_GetOverlayPosition(p,a,b)    (p)->lpVtbl->GetOverlayPosition(p,a,b)
  1501. #define IDirectDrawSurface_GetPalette(p,a)              (p)->lpVtbl->GetPalette(p,a)
  1502. #define IDirectDrawSurface_GetPixelFormat(p,a)          (p)->lpVtbl->GetPixelFormat(p,a)
  1503. #define IDirectDrawSurface_GetSurfaceDesc(p,a)          (p)->lpVtbl->GetSurfaceDesc(p,a)
  1504. #define IDirectDrawSurface_Initialize(p,a,b)            (p)->lpVtbl->Initialize(p,a,b)
  1505. #define IDirectDrawSurface_IsLost(p)                    (p)->lpVtbl->IsLost(p)
  1506. #define IDirectDrawSurface_Lock(p,a,b,c,d)              (p)->lpVtbl->Lock(p,a,b,c,d)
  1507. #define IDirectDrawSurface_ReleaseDC(p,a)               (p)->lpVtbl->ReleaseDC(p,a)
  1508. #define IDirectDrawSurface_Restore(p)                   (p)->lpVtbl->Restore(p)
  1509. #define IDirectDrawSurface_SetClipper(p,a)              (p)->lpVtbl->SetClipper(p,a)
  1510. #define IDirectDrawSurface_SetColorKey(p,a,b)           (p)->lpVtbl->SetColorKey(p,a,b)
  1511. #define IDirectDrawSurface_SetOverlayPosition(p,a,b)    (p)->lpVtbl->SetOverlayPosition(p,a,b)
  1512. #define IDirectDrawSurface_SetPalette(p,a)              (p)->lpVtbl->SetPalette(p,a)
  1513. #define IDirectDrawSurface_Unlock(p,b)                  (p)->lpVtbl->Unlock(p,b)
  1514. #define IDirectDrawSurface_UpdateOverlay(p,a,b,c,d,e)   (p)->lpVtbl->UpdateOverlay(p,a,b,c,d,e)
  1515. #define IDirectDrawSurface_UpdateOverlayDisplay(p,a)    (p)->lpVtbl->UpdateOverlayDisplay(p,a)
  1516. #define IDirectDrawSurface_UpdateOverlayZOrder(p,a,b)   (p)->lpVtbl->UpdateOverlayZOrder(p,a,b)
  1517. #else
  1518. #define IDirectDrawSurface_QueryInterface(p,a,b)        (p)->QueryInterface(a,b)
  1519. #define IDirectDrawSurface_AddRef(p)                    (p)->AddRef()
  1520. #define IDirectDrawSurface_Release(p)                   (p)->Release()
  1521. #define IDirectDrawSurface_AddAttachedSurface(p,a)      (p)->AddAttachedSurface(a)
  1522. #define IDirectDrawSurface_AddOverlayDirtyRect(p,a)     (p)->AddOverlayDirtyRect(a)
  1523. #define IDirectDrawSurface_Blt(p,a,b,c,d,e)             (p)->Blt(a,b,c,d,e)
  1524. #define IDirectDrawSurface_BltBatch(p,a,b,c)            (p)->BltBatch(a,b,c)
  1525. #define IDirectDrawSurface_BltFast(p,a,b,c,d,e)         (p)->BltFast(a,b,c,d,e)
  1526. #define IDirectDrawSurface_DeleteAttachedSurface(p,a,b) (p)->DeleteAttachedSurface(a,b)
  1527. #define IDirectDrawSurface_EnumAttachedSurfaces(p,a,b)  (p)->EnumAttachedSurfaces(a,b)
  1528. #define IDirectDrawSurface_EnumOverlayZOrders(p,a,b,c)  (p)->EnumOverlayZOrders(a,b,c)
  1529. #define IDirectDrawSurface_Flip(p,a,b)                  (p)->Flip(a,b)
  1530. #define IDirectDrawSurface_GetAttachedSurface(p,a,b)    (p)->GetAttachedSurface(a,b)
  1531. #define IDirectDrawSurface_GetBltStatus(p,a)            (p)->GetBltStatus(a)
  1532. #define IDirectDrawSurface_GetCaps(p,b)                 (p)->GetCaps(b)
  1533. #define IDirectDrawSurface_GetClipper(p,a)              (p)->GetClipper(a)
  1534. #define IDirectDrawSurface_GetColorKey(p,a,b)           (p)->GetColorKey(a,b)
  1535. #define IDirectDrawSurface_GetDC(p,a)                   (p)->GetDC(a)
  1536. #define IDirectDrawSurface_GetFlipStatus(p,a)           (p)->GetFlipStatus(a)
  1537. #define IDirectDrawSurface_GetOverlayPosition(p,a,b)    (p)->GetOverlayPosition(a,b)
  1538. #define IDirectDrawSurface_GetPalette(p,a)              (p)->GetPalette(a)
  1539. #define IDirectDrawSurface_GetPixelFormat(p,a)          (p)->GetPixelFormat(a)
  1540. #define IDirectDrawSurface_GetSurfaceDesc(p,a)          (p)->GetSurfaceDesc(a)
  1541. #define IDirectDrawSurface_Initialize(p,a,b)            (p)->Initialize(a,b)
  1542. #define IDirectDrawSurface_IsLost(p)                    (p)->IsLost()
  1543. #define IDirectDrawSurface_Lock(p,a,b,c,d)              (p)->Lock(a,b,c,d)
  1544. #define IDirectDrawSurface_ReleaseDC(p,a)               (p)->ReleaseDC(a)
  1545. #define IDirectDrawSurface_Restore(p)                   (p)->Restore()
  1546. #define IDirectDrawSurface_SetClipper(p,a)              (p)->SetClipper(a)
  1547. #define IDirectDrawSurface_SetColorKey(p,a,b)           (p)->SetColorKey(a,b)
  1548. #define IDirectDrawSurface_SetOverlayPosition(p,a,b)    (p)->SetOverlayPosition(a,b)
  1549. #define IDirectDrawSurface_SetPalette(p,a)              (p)->SetPalette(a)
  1550. #define IDirectDrawSurface_Unlock(p,b)                  (p)->Unlock(b)
  1551. #define IDirectDrawSurface_UpdateOverlay(p,a,b,c,d,e)   (p)->UpdateOverlay(a,b,c,d,e)
  1552. #define IDirectDrawSurface_UpdateOverlayDisplay(p,a)    (p)->UpdateOverlayDisplay(a)
  1553. #define IDirectDrawSurface_UpdateOverlayZOrder(p,a,b)   (p)->UpdateOverlayZOrder(a,b)
  1554. #endif
  1555.  
  1556. /*
  1557.  * IDirectDrawSurface2 and related interfaces
  1558.  */
  1559. #undef INTERFACE
  1560. #define INTERFACE IDirectDrawSurface2
  1561. DECLARE_INTERFACE_( IDirectDrawSurface2, IUnknown )
  1562. {
  1563.     /*** IUnknown methods ***/
  1564.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE;
  1565.     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
  1566.     STDMETHOD_(ULONG,Release) (THIS) PURE;
  1567.     /*** IDirectDrawSurface methods ***/
  1568.     STDMETHOD(AddAttachedSurface)(THIS_ LPDIRECTDRAWSURFACE2) PURE;
  1569.     STDMETHOD(AddOverlayDirtyRect)(THIS_ LPRECT) PURE;
  1570.     STDMETHOD(Blt)(THIS_ LPRECT,LPDIRECTDRAWSURFACE2, LPRECT,DWORD, LPDDBLTFX) PURE;
  1571.     STDMETHOD(BltBatch)(THIS_ LPDDBLTBATCH, DWORD, DWORD ) PURE;
  1572.     STDMETHOD(BltFast)(THIS_ DWORD,DWORD,LPDIRECTDRAWSURFACE2, LPRECT,DWORD) PURE;
  1573.     STDMETHOD(DeleteAttachedSurface)(THIS_ DWORD,LPDIRECTDRAWSURFACE2) PURE;
  1574.     STDMETHOD(EnumAttachedSurfaces)(THIS_ LPVOID,LPDDENUMSURFACESCALLBACK) PURE;
  1575.     STDMETHOD(EnumOverlayZOrders)(THIS_ DWORD,LPVOID,LPDDENUMSURFACESCALLBACK) PURE;
  1576.     STDMETHOD(Flip)(THIS_ LPDIRECTDRAWSURFACE2, DWORD) PURE;
  1577.     STDMETHOD(GetAttachedSurface)(THIS_ LPDDSCAPS, LPDIRECTDRAWSURFACE2 FAR *) PURE;
  1578.     STDMETHOD(GetBltStatus)(THIS_ DWORD) PURE;
  1579.     STDMETHOD(GetCaps)(THIS_ LPDDSCAPS) PURE;
  1580.     STDMETHOD(GetClipper)(THIS_ LPDIRECTDRAWCLIPPER FAR*) PURE;
  1581.     STDMETHOD(GetColorKey)(THIS_ DWORD, LPDDCOLORKEY) PURE;
  1582.     STDMETHOD(GetDC)(THIS_ HDC FAR *) PURE;
  1583.     STDMETHOD(GetFlipStatus)(THIS_ DWORD) PURE;
  1584.     STDMETHOD(GetOverlayPosition)(THIS_ LPLONG, LPLONG ) PURE;
  1585.     STDMETHOD(GetPalette)(THIS_ LPDIRECTDRAWPALETTE FAR*) PURE;
  1586.     STDMETHOD(GetPixelFormat)(THIS_ LPDDPIXELFORMAT) PURE;
  1587.     STDMETHOD(GetSurfaceDesc)(THIS_ LPDDSURFACEDESC) PURE;
  1588.     STDMETHOD(Initialize)(THIS_ LPDIRECTDRAW, LPDDSURFACEDESC) PURE;
  1589.     STDMETHOD(IsLost)(THIS) PURE;
  1590.     STDMETHOD(Lock)(THIS_ LPRECT,LPDDSURFACEDESC,DWORD,HANDLE) PURE;
  1591.     STDMETHOD(ReleaseDC)(THIS_ HDC) PURE;
  1592.     STDMETHOD(Restore)(THIS) PURE;
  1593.     STDMETHOD(SetClipper)(THIS_ LPDIRECTDRAWCLIPPER) PURE;
  1594.     STDMETHOD(SetColorKey)(THIS_ DWORD, LPDDCOLORKEY) PURE;
  1595.     STDMETHOD(SetOverlayPosition)(THIS_ LONG, LONG ) PURE;
  1596.     STDMETHOD(SetPalette)(THIS_ LPDIRECTDRAWPALETTE) PURE;
  1597.     STDMETHOD(Unlock)(THIS_ LPVOID) PURE;
  1598.     STDMETHOD(UpdateOverlay)(THIS_ LPRECT, LPDIRECTDRAWSURFACE2,LPRECT,DWORD, LPDDOVERLAYFX) PURE;
  1599.     STDMETHOD(UpdateOverlayDisplay)(THIS_ DWORD) PURE;
  1600.     STDMETHOD(UpdateOverlayZOrder)(THIS_ DWORD, LPDIRECTDRAWSURFACE2) PURE;
  1601.     /*** Added in the v2 interface ***/
  1602.     STDMETHOD(GetDDInterface)(THIS_ LPVOID FAR *) PURE;
  1603.     STDMETHOD(PageLock)(THIS_ DWORD) PURE;
  1604.     STDMETHOD(PageUnlock)(THIS_ DWORD) PURE;
  1605. };
  1606.  
  1607. #if !defined(__cplusplus) || defined(CINTERFACE)
  1608. #define IDirectDrawSurface2_QueryInterface(p,a,b)        (p)->lpVtbl->QueryInterface(p,a,b)
  1609. #define IDirectDrawSurface2_AddRef(p)                    (p)->lpVtbl->AddRef(p)
  1610. #define IDirectDrawSurface2_Release(p)                   (p)->lpVtbl->Release(p)
  1611. #define IDirectDrawSurface2_AddAttachedSurface(p,a)      (p)->lpVtbl->AddAttachedSurface(p,a)
  1612. #define IDirectDrawSurface2_AddOverlayDirtyRect(p,a)     (p)->lpVtbl->AddOverlayDirtyRect(p,a)
  1613. #define IDirectDrawSurface2_Blt(p,a,b,c,d,e)             (p)->lpVtbl->Blt(p,a,b,c,d,e)
  1614. #define IDirectDrawSurface2_BltBatch(p,a,b,c)            (p)->lpVtbl->BltBatch(p,a,b,c)
  1615. #define IDirectDrawSurface2_BltFast(p,a,b,c,d,e)         (p)->lpVtbl->BltFast(p,a,b,c,d,e)
  1616. #define IDirectDrawSurface2_DeleteAttachedSurface(p,a,b) (p)->lpVtbl->DeleteAttachedSurface(p,a,b)
  1617. #define IDirectDrawSurface2_EnumAttachedSurfaces(p,a,b)  (p)->lpVtbl->EnumAttachedSurfaces(p,a,b)
  1618. #define IDirectDrawSurface2_EnumOverlayZOrders(p,a,b,c)  (p)->lpVtbl->EnumOverlayZOrders(p,a,b,c)
  1619. #define IDirectDrawSurface2_Flip(p,a,b)                  (p)->lpVtbl->Flip(p,a,b)
  1620. #define IDirectDrawSurface2_GetAttachedSurface(p,a,b)    (p)->lpVtbl->GetAttachedSurface(p,a,b)
  1621. #define IDirectDrawSurface2_GetBltStatus(p,a)            (p)->lpVtbl->GetBltStatus(p,a)
  1622. #define IDirectDrawSurface2_GetCaps(p,b)                 (p)->lpVtbl->GetCaps(p,b)
  1623. #define IDirectDrawSurface2_GetClipper(p,a)              (p)->lpVtbl->GetClipper(p,a)
  1624. #define IDirectDrawSurface2_GetColorKey(p,a,b)           (p)->lpVtbl->GetColorKey(p,a,b)
  1625. #define IDirectDrawSurface2_GetDC(p,a)                   (p)->lpVtbl->GetDC(p,a)
  1626. #define IDirectDrawSurface2_GetFlipStatus(p,a)           (p)->lpVtbl->GetFlipStatus(p,a)
  1627. #define IDirectDrawSurface2_GetOverlayPosition(p,a,b)    (p)->lpVtbl->GetOverlayPosition(p,a,b)
  1628. #define IDirectDrawSurface2_GetPalette(p,a)              (p)->lpVtbl->GetPalette(p,a)
  1629. #define IDirectDrawSurface2_GetPixelFormat(p,a)          (p)->lpVtbl->GetPixelFormat(p,a)
  1630. #define IDirectDrawSurface2_GetSurfaceDesc(p,a)          (p)->lpVtbl->GetSurfaceDesc(p,a)
  1631. #define IDirectDrawSurface2_Initialize(p,a,b)            (p)->lpVtbl->Initialize(p,a,b)
  1632. #define IDirectDrawSurface2_IsLost(p)                    (p)->lpVtbl->IsLost(p)
  1633. #define IDirectDrawSurface2_Lock(p,a,b,c,d)              (p)->lpVtbl->Lock(p,a,b,c,d)
  1634. #define IDirectDrawSurface2_ReleaseDC(p,a)               (p)->lpVtbl->ReleaseDC(p,a)
  1635. #define IDirectDrawSurface2_Restore(p)                   (p)->lpVtbl->Restore(p)
  1636. #define IDirectDrawSurface2_SetClipper(p,a)              (p)->lpVtbl->SetClipper(p,a)
  1637. #define IDirectDrawSurface2_SetColorKey(p,a,b)           (p)->lpVtbl->SetColorKey(p,a,b)
  1638. #define IDirectDrawSurface2_SetOverlayPosition(p,a,b)    (p)->lpVtbl->SetOverlayPosition(p,a,b)
  1639. #define IDirectDrawSurface2_SetPalette(p,a)              (p)->lpVtbl->SetPalette(p,a)
  1640. #define IDirectDrawSurface2_Unlock(p,b)                  (p)->lpVtbl->Unlock(p,b)
  1641. #define IDirectDrawSurface2_UpdateOverlay(p,a,b,c,d,e)   (p)->lpVtbl->UpdateOverlay(p,a,b,c,d,e)
  1642. #define IDirectDrawSurface2_UpdateOverlayDisplay(p,a)    (p)->lpVtbl->UpdateOverlayDisplay(p,a)
  1643. #define IDirectDrawSurface2_UpdateOverlayZOrder(p,a,b)   (p)->lpVtbl->UpdateOverlayZOrder(p,a,b)
  1644. #define IDirectDrawSurface2_GetDDInterface(p,a)          (p)->lpVtbl->GetDDInterface(p,a)
  1645. #define IDirectDrawSurface2_PageLock(p,a)                (p)->lpVtbl->PageLock(p,a)
  1646. #define IDirectDrawSurface2_PageUnlock(p,a)              (p)->lpVtbl->PageUnlock(p,a)
  1647. #else
  1648. #define IDirectDrawSurface2_QueryInterface(p,a,b)        (p)->QueryInterface(a,b)
  1649. #define IDirectDrawSurface2_AddRef(p)                    (p)->AddRef()
  1650. #define IDirectDrawSurface2_Release(p)                   (p)->Release()
  1651. #define IDirectDrawSurface2_AddAttachedSurface(p,a)      (p)->AddAttachedSurface(a)
  1652. #define IDirectDrawSurface2_AddOverlayDirtyRect(p,a)     (p)->AddOverlayDirtyRect(a)
  1653. #define IDirectDrawSurface2_Blt(p,a,b,c,d,e)             (p)->Blt(a,b,c,d,e)
  1654. #define IDirectDrawSurface2_BltBatch(p,a,b,c)            (p)->BltBatch(a,b,c)
  1655. #define IDirectDrawSurface2_BltFast(p,a,b,c,d,e)         (p)->BltFast(a,b,c,d,e)
  1656. #define IDirectDrawSurface2_DeleteAttachedSurface(p,a,b) (p)->DeleteAttachedSurface(a,b)
  1657. #define IDirectDrawSurface2_EnumAttachedSurfaces(p,a,b)  (p)->EnumAttachedSurfaces(a,b)
  1658. #define IDirectDrawSurface2_EnumOverlayZOrders(p,a,b,c)  (p)->EnumOverlayZOrders(a,b,c)
  1659. #define IDirectDrawSurface2_Flip(p,a,b)                  (p)->Flip(a,b)
  1660. #define IDirectDrawSurface2_GetAttachedSurface(p,a,b)    (p)->GetAttachedSurface(a,b)
  1661. #define IDirectDrawSurface2_GetBltStatus(p,a)            (p)->GetBltStatus(a)
  1662. #define IDirectDrawSurface2_GetCaps(p,b)                 (p)->GetCaps(b)
  1663. #define IDirectDrawSurface2_GetClipper(p,a)              (p)->GetClipper(a)
  1664. #define IDirectDrawSurface2_GetColorKey(p,a,b)           (p)->GetColorKey(a,b)
  1665. #define IDirectDrawSurface2_GetDC(p,a)                   (p)->GetDC(a)
  1666. #define IDirectDrawSurface2_GetFlipStatus(p,a)           (p)->GetFlipStatus(a)
  1667. #define IDirectDrawSurface2_GetOverlayPosition(p,a,b)    (p)->GetOverlayPosition(a,b)
  1668. #define IDirectDrawSurface2_GetPalette(p,a)              (p)->GetPalette(a)
  1669. #define IDirectDrawSurface2_GetPixelFormat(p,a)          (p)->GetPixelFormat(a)
  1670. #define IDirectDrawSurface2_GetSurfaceDesc(p,a)          (p)->GetSurfaceDesc(a)
  1671. #define IDirectDrawSurface2_Initialize(p,a,b)            (p)->Initialize(a,b)
  1672. #define IDirectDrawSurface2_IsLost(p)                    (p)->IsLost()
  1673. #define IDirectDrawSurface2_Lock(p,a,b,c,d)              (p)->Lock(a,b,c,d)
  1674. #define IDirectDrawSurface2_ReleaseDC(p,a)               (p)->ReleaseDC(a)
  1675. #define IDirectDrawSurface2_Restore(p)                   (p)->Restore()
  1676. #define IDirectDrawSurface2_SetClipper(p,a)              (p)->SetClipper(a)
  1677. #define IDirectDrawSurface2_SetColorKey(p,a,b)           (p)->SetColorKey(a,b)
  1678. #define IDirectDrawSurface2_SetOverlayPosition(p,a,b)    (p)->SetOverlayPosition(a,b)
  1679. #define IDirectDrawSurface2_SetPalette(p,a)              (p)->SetPalette(a)
  1680. #define IDirectDrawSurface2_Unlock(p,b)                  (p)->Unlock(b)
  1681. #define IDirectDrawSurface2_UpdateOverlay(p,a,b,c,d,e)   (p)->UpdateOverlay(a,b,c,d,e)
  1682. #define IDirectDrawSurface2_UpdateOverlayDisplay(p,a)    (p)->UpdateOverlayDisplay(a)
  1683. #define IDirectDrawSurface2_UpdateOverlayZOrder(p,a,b)   (p)->UpdateOverlayZOrder(a,b)
  1684. #define IDirectDrawSurface2_GetDDInterface(p,a)          (p)->GetDDInterface(a)
  1685. #define IDirectDrawSurface2_PageLock(p,a)                (p)->PageLock(a)
  1686. #define IDirectDrawSurface2_PageUnlock(p,a)              (p)->PageUnlock(a)
  1687. #endif
  1688.  
  1689. /*
  1690.  * IDirectDrawSurface3 and related interfaces
  1691.  */
  1692. #undef INTERFACE
  1693. #define INTERFACE IDirectDrawSurface3
  1694. DECLARE_INTERFACE_( IDirectDrawSurface3, IUnknown )
  1695. {
  1696.     /*** IUnknown methods ***/
  1697.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE;
  1698.     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
  1699.     STDMETHOD_(ULONG,Release) (THIS) PURE;
  1700.     /*** IDirectDrawSurface methods ***/
  1701.     STDMETHOD(AddAttachedSurface)(THIS_ LPDIRECTDRAWSURFACE3) PURE;
  1702.     STDMETHOD(AddOverlayDirtyRect)(THIS_ LPRECT) PURE;
  1703.     STDMETHOD(Blt)(THIS_ LPRECT,LPDIRECTDRAWSURFACE3, LPRECT,DWORD, LPDDBLTFX) PURE;
  1704.     STDMETHOD(BltBatch)(THIS_ LPDDBLTBATCH, DWORD, DWORD ) PURE;
  1705.     STDMETHOD(BltFast)(THIS_ DWORD,DWORD,LPDIRECTDRAWSURFACE3, LPRECT,DWORD) PURE;
  1706.     STDMETHOD(DeleteAttachedSurface)(THIS_ DWORD,LPDIRECTDRAWSURFACE3) PURE;
  1707.     STDMETHOD(EnumAttachedSurfaces)(THIS_ LPVOID,LPDDENUMSURFACESCALLBACK) PURE;
  1708.     STDMETHOD(EnumOverlayZOrders)(THIS_ DWORD,LPVOID,LPDDENUMSURFACESCALLBACK) PURE;
  1709.     STDMETHOD(Flip)(THIS_ LPDIRECTDRAWSURFACE3, DWORD) PURE;
  1710.     STDMETHOD(GetAttachedSurface)(THIS_ LPDDSCAPS, LPDIRECTDRAWSURFACE3 FAR *) PURE;
  1711.     STDMETHOD(GetBltStatus)(THIS_ DWORD) PURE;
  1712.     STDMETHOD(GetCaps)(THIS_ LPDDSCAPS) PURE;
  1713.     STDMETHOD(GetClipper)(THIS_ LPDIRECTDRAWCLIPPER FAR*) PURE;
  1714.     STDMETHOD(GetColorKey)(THIS_ DWORD, LPDDCOLORKEY) PURE;
  1715.     STDMETHOD(GetDC)(THIS_ HDC FAR *) PURE;
  1716.     STDMETHOD(GetFlipStatus)(THIS_ DWORD) PURE;
  1717.     STDMETHOD(GetOverlayPosition)(THIS_ LPLONG, LPLONG ) PURE;
  1718.     STDMETHOD(GetPalette)(THIS_ LPDIRECTDRAWPALETTE FAR*) PURE;
  1719.     STDMETHOD(GetPixelFormat)(THIS_ LPDDPIXELFORMAT) PURE;
  1720.     STDMETHOD(GetSurfaceDesc)(THIS_ LPDDSURFACEDESC) PURE;
  1721.     STDMETHOD(Initialize)(THIS_ LPDIRECTDRAW, LPDDSURFACEDESC) PURE;
  1722.     STDMETHOD(IsLost)(THIS) PURE;
  1723.     STDMETHOD(Lock)(THIS_ LPRECT,LPDDSURFACEDESC,DWORD,HANDLE) PURE;
  1724.     STDMETHOD(ReleaseDC)(THIS_ HDC) PURE;
  1725.     STDMETHOD(Restore)(THIS) PURE;
  1726.     STDMETHOD(SetClipper)(THIS_ LPDIRECTDRAWCLIPPER) PURE;
  1727.     STDMETHOD(SetColorKey)(THIS_ DWORD, LPDDCOLORKEY) PURE;
  1728.     STDMETHOD(SetOverlayPosition)(THIS_ LONG, LONG ) PURE;
  1729.     STDMETHOD(SetPalette)(THIS_ LPDIRECTDRAWPALETTE) PURE;
  1730.     STDMETHOD(Unlock)(THIS_ LPVOID) PURE;
  1731.     STDMETHOD(UpdateOverlay)(THIS_ LPRECT, LPDIRECTDRAWSURFACE3,LPRECT,DWORD, LPDDOVERLAYFX) PURE;
  1732.     STDMETHOD(UpdateOverlayDisplay)(THIS_ DWORD) PURE;
  1733.     STDMETHOD(UpdateOverlayZOrder)(THIS_ DWORD, LPDIRECTDRAWSURFACE3) PURE;
  1734.     /*** Added in the v2 interface ***/
  1735.     STDMETHOD(GetDDInterface)(THIS_ LPVOID FAR *) PURE;
  1736.     STDMETHOD(PageLock)(THIS_ DWORD) PURE;
  1737.     STDMETHOD(PageUnlock)(THIS_ DWORD) PURE;
  1738.     /*** Added in the V3 interface ***/
  1739.     STDMETHOD(SetSurfaceDesc)(THIS_ LPDDSURFACEDESC, DWORD) PURE;
  1740. };
  1741.  
  1742. #if !defined(__cplusplus) || defined(CINTERFACE)
  1743. #define IDirectDrawSurface3_QueryInterface(p,a,b)        (p)->lpVtbl->QueryInterface(p,a,b)
  1744. #define IDirectDrawSurface3_AddRef(p)                    (p)->lpVtbl->AddRef(p)
  1745. #define IDirectDrawSurface3_Release(p)                   (p)->lpVtbl->Release(p)
  1746. #define IDirectDrawSurface3_AddAttachedSurface(p,a)      (p)->lpVtbl->AddAttachedSurface(p,a)
  1747. #define IDirectDrawSurface3_AddOverlayDirtyRect(p,a)     (p)->lpVtbl->AddOverlayDirtyRect(p,a)
  1748. #define IDirectDrawSurface3_Blt(p,a,b,c,d,e)             (p)->lpVtbl->Blt(p,a,b,c,d,e)
  1749. #define IDirectDrawSurface3_BltBatch(p,a,b,c)            (p)->lpVtbl->BltBatch(p,a,b,c)
  1750. #define IDirectDrawSurface3_BltFast(p,a,b,c,d,e)         (p)->lpVtbl->BltFast(p,a,b,c,d,e)
  1751. #define IDirectDrawSurface3_DeleteAttachedSurface(p,a,b) (p)->lpVtbl->DeleteAttachedSurface(p,a,b)
  1752. #define IDirectDrawSurface3_EnumAttachedSurfaces(p,a,b)  (p)->lpVtbl->EnumAttachedSurfaces(p,a,b)
  1753. #define IDirectDrawSurface3_EnumOverlayZOrders(p,a,b,c)  (p)->lpVtbl->EnumOverlayZOrders(p,a,b,c)
  1754. #define IDirectDrawSurface3_Flip(p,a,b)                  (p)->lpVtbl->Flip(p,a,b)
  1755. #define IDirectDrawSurface3_GetAttachedSurface(p,a,b)    (p)->lpVtbl->GetAttachedSurface(p,a,b)
  1756. #define IDirectDrawSurface3_GetBltStatus(p,a)            (p)->lpVtbl->GetBltStatus(p,a)
  1757. #define IDirectDrawSurface3_GetCaps(p,b)                 (p)->lpVtbl->GetCaps(p,b)
  1758. #define IDirectDrawSurface3_GetClipper(p,a)              (p)->lpVtbl->GetClipper(p,a)
  1759. #define IDirectDrawSurface3_GetColorKey(p,a,b)           (p)->lpVtbl->GetColorKey(p,a,b)
  1760. #define IDirectDrawSurface3_GetDC(p,a)                   (p)->lpVtbl->GetDC(p,a)
  1761. #define IDirectDrawSurface3_GetFlipStatus(p,a)           (p)->lpVtbl->GetFlipStatus(p,a)
  1762. #define IDirectDrawSurface3_GetOverlayPosition(p,a,b)    (p)->lpVtbl->GetOverlayPosition(p,a,b)
  1763. #define IDirectDrawSurface3_GetPalette(p,a)              (p)->lpVtbl->GetPalette(p,a)
  1764. #define IDirectDrawSurface3_GetPixelFormat(p,a)          (p)->lpVtbl->GetPixelFormat(p,a)
  1765. #define IDirectDrawSurface3_GetSurfaceDesc(p,a)          (p)->lpVtbl->GetSurfaceDesc(p,a)
  1766. #define IDirectDrawSurface3_Initialize(p,a,b)            (p)->lpVtbl->Initialize(p,a,b)
  1767. #define IDirectDrawSurface3_IsLost(p)                    (p)->lpVtbl->IsLost(p)
  1768. #define IDirectDrawSurface3_Lock(p,a,b,c,d)              (p)->lpVtbl->Lock(p,a,b,c,d)
  1769. #define IDirectDrawSurface3_ReleaseDC(p,a)               (p)->lpVtbl->ReleaseDC(p,a)
  1770. #define IDirectDrawSurface3_Restore(p)                   (p)->lpVtbl->Restore(p)
  1771. #define IDirectDrawSurface3_SetClipper(p,a)              (p)->lpVtbl->SetClipper(p,a)
  1772. #define IDirectDrawSurface3_SetColorKey(p,a,b)           (p)->lpVtbl->SetColorKey(p,a,b)
  1773. #define IDirectDrawSurface3_SetOverlayPosition(p,a,b)    (p)->lpVtbl->SetOverlayPosition(p,a,b)
  1774. #define IDirectDrawSurface3_SetPalette(p,a)              (p)->lpVtbl->SetPalette(p,a)
  1775. #define IDirectDrawSurface3_Unlock(p,b)                  (p)->lpVtbl->Unlock(p,b)
  1776. #define IDirectDrawSurface3_UpdateOverlay(p,a,b,c,d,e)   (p)->lpVtbl->UpdateOverlay(p,a,b,c,d,e)
  1777. #define IDirectDrawSurface3_UpdateOverlayDisplay(p,a)    (p)->lpVtbl->UpdateOverlayDisplay(p,a)
  1778. #define IDirectDrawSurface3_UpdateOverlayZOrder(p,a,b)   (p)->lpVtbl->UpdateOverlayZOrder(p,a,b)
  1779. #define IDirectDrawSurface3_GetDDInterface(p,a)          (p)->lpVtbl->GetDDInterface(p,a)
  1780. #define IDirectDrawSurface3_PageLock(p,a)                (p)->lpVtbl->PageLock(p,a)
  1781. #define IDirectDrawSurface3_PageUnlock(p,a)              (p)->lpVtbl->PageUnlock(p,a)
  1782. #define IDirectDrawSurface3_SetSurfaceDesc(p,a,b)        (p)->lpVtbl->SetSurfaceDesc(p,a,b)
  1783. #else
  1784. #define IDirectDrawSurface3_QueryInterface(p,a,b)        (p)->QueryInterface(a,b)
  1785. #define IDirectDrawSurface3_AddRef(p)                    (p)->AddRef()
  1786. #define IDirectDrawSurface3_Release(p)                   (p)->Release()
  1787. #define IDirectDrawSurface3_AddAttachedSurface(p,a)      (p)->AddAttachedSurface(a)
  1788. #define IDirectDrawSurface3_AddOverlayDirtyRect(p,a)     (p)->AddOverlayDirtyRect(a)
  1789. #define IDirectDrawSurface3_Blt(p,a,b,c,d,e)             (p)->Blt(a,b,c,d,e)
  1790. #define IDirectDrawSurface3_BltBatch(p,a,b,c)            (p)->BltBatch(a,b,c)
  1791. #define IDirectDrawSurface3_BltFast(p,a,b,c,d,e)         (p)->BltFast(a,b,c,d,e)
  1792. #define IDirectDrawSurface3_DeleteAttachedSurface(p,a,b) (p)->DeleteAttachedSurface(a,b)
  1793. #define IDirectDrawSurface3_EnumAttachedSurfaces(p,a,b)  (p)->EnumAttachedSurfaces(a,b)
  1794. #define IDirectDrawSurface3_EnumOverlayZOrders(p,a,b,c)  (p)->EnumOverlayZOrders(a,b,c)
  1795. #define IDirectDrawSurface3_Flip(p,a,b)                  (p)->Flip(a,b)
  1796. #define IDirectDrawSurface3_GetAttachedSurface(p,a,b)    (p)->GetAttachedSurface(a,b)
  1797. #define IDirectDrawSurface3_GetBltStatus(p,a)            (p)->GetBltStatus(a)
  1798. #define IDirectDrawSurface3_GetCaps(p,b)                 (p)->GetCaps(b)
  1799. #define IDirectDrawSurface3_GetClipper(p,a)              (p)->GetClipper(a)
  1800. #define IDirectDrawSurface3_GetColorKey(p,a,b)           (p)->GetColorKey(a,b)
  1801. #define IDirectDrawSurface3_GetDC(p,a)                   (p)->GetDC(a)
  1802. #define IDirectDrawSurface3_GetFlipStatus(p,a)           (p)->GetFlipStatus(a)
  1803. #define IDirectDrawSurface3_GetOverlayPosition(p,a,b)    (p)->GetOverlayPosition(a,b)
  1804. #define IDirectDrawSurface3_GetPalette(p,a)              (p)->GetPalette(a)
  1805. #define IDirectDrawSurface3_GetPixelFormat(p,a)          (p)->GetPixelFormat(a)
  1806. #define IDirectDrawSurface3_GetSurfaceDesc(p,a)          (p)->GetSurfaceDesc(a)
  1807. #define IDirectDrawSurface3_Initialize(p,a,b)            (p)->Initialize(a,b)
  1808. #define IDirectDrawSurface3_IsLost(p)                    (p)->IsLost()
  1809. #define IDirectDrawSurface3_Lock(p,a,b,c,d)              (p)->Lock(a,b,c,d)
  1810. #define IDirectDrawSurface3_ReleaseDC(p,a)               (p)->ReleaseDC(a)
  1811. #define IDirectDrawSurface3_Restore(p)                   (p)->Restore()
  1812. #define IDirectDrawSurface3_SetClipper(p,a)              (p)->SetClipper(a)
  1813. #define IDirectDrawSurface3_SetColorKey(p,a,b)           (p)->SetColorKey(a,b)
  1814. #define IDirectDrawSurface3_SetOverlayPosition(p,a,b)    (p)->SetOverlayPosition(a,b)
  1815. #define IDirectDrawSurface3_SetPalette(p,a)              (p)->SetPalette(a)
  1816. #define IDirectDrawSurface3_Unlock(p,b)                  (p)->Unlock(b)
  1817. #define IDirectDrawSurface3_UpdateOverlay(p,a,b,c,d,e)   (p)->UpdateOverlay(a,b,c,d,e)
  1818. #define IDirectDrawSurface3_UpdateOverlayDisplay(p,a)    (p)->UpdateOverlayDisplay(a)
  1819. #define IDirectDrawSurface3_UpdateOverlayZOrder(p,a,b)   (p)->UpdateOverlayZOrder(a,b)
  1820. #define IDirectDrawSurface3_GetDDInterface(p,a)          (p)->GetDDInterface(a)
  1821. #define IDirectDrawSurface3_PageLock(p,a)                (p)->PageLock(a)
  1822. #define IDirectDrawSurface3_PageUnlock(p,a)              (p)->PageUnlock(a)
  1823. #define IDirectDrawSurface3_SetSurfaceDesc(p,a,b)        (p)->SetSurfaceDesc(a,b)
  1824. #endif
  1825.  
  1826. /*
  1827.  * IDirectDrawSurface4 and related interfaces
  1828.  */
  1829. #undef INTERFACE
  1830. #define INTERFACE IDirectDrawSurface4
  1831. DECLARE_INTERFACE_( IDirectDrawSurface4, IUnknown )
  1832. {
  1833.     /*** IUnknown methods ***/
  1834.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE;
  1835.     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
  1836.     STDMETHOD_(ULONG,Release) (THIS) PURE;
  1837.     /*** IDirectDrawSurface methods ***/
  1838.     STDMETHOD(AddAttachedSurface)(THIS_ LPDIRECTDRAWSURFACE4) PURE;
  1839.     STDMETHOD(AddOverlayDirtyRect)(THIS_ LPRECT) PURE;
  1840.     STDMETHOD(Blt)(THIS_ LPRECT,LPDIRECTDRAWSURFACE4, LPRECT,DWORD, LPDDBLTFX) PURE;
  1841.     STDMETHOD(BltBatch)(THIS_ LPDDBLTBATCH, DWORD, DWORD ) PURE;
  1842.     STDMETHOD(BltFast)(THIS_ DWORD,DWORD,LPDIRECTDRAWSURFACE4, LPRECT,DWORD) PURE;
  1843.     STDMETHOD(DeleteAttachedSurface)(THIS_ DWORD,LPDIRECTDRAWSURFACE4) PURE;
  1844.     STDMETHOD(EnumAttachedSurfaces)(THIS_ LPVOID,LPDDENUMSURFACESCALLBACK2) PURE;
  1845.     STDMETHOD(EnumOverlayZOrders)(THIS_ DWORD,LPVOID,LPDDENUMSURFACESCALLBACK2) PURE;
  1846.     STDMETHOD(Flip)(THIS_ LPDIRECTDRAWSURFACE4, DWORD) PURE;
  1847.     STDMETHOD(GetAttachedSurface)(THIS_ LPDDSCAPS2, LPDIRECTDRAWSURFACE4 FAR *) PURE;
  1848.     STDMETHOD(GetBltStatus)(THIS_ DWORD) PURE;
  1849.     STDMETHOD(GetCaps)(THIS_ LPDDSCAPS2) PURE;
  1850.     STDMETHOD(GetClipper)(THIS_ LPDIRECTDRAWCLIPPER FAR*) PURE;
  1851.     STDMETHOD(GetColorKey)(THIS_ DWORD, LPDDCOLORKEY) PURE;
  1852.     STDMETHOD(GetDC)(THIS_ HDC FAR *) PURE;
  1853.     STDMETHOD(GetFlipStatus)(THIS_ DWORD) PURE;
  1854.     STDMETHOD(GetOverlayPosition)(THIS_ LPLONG, LPLONG ) PURE;
  1855.     STDMETHOD(GetPalette)(THIS_ LPDIRECTDRAWPALETTE FAR*) PURE;
  1856.     STDMETHOD(GetPixelFormat)(THIS_ LPDDPIXELFORMAT) PURE;
  1857.     STDMETHOD(GetSurfaceDesc)(THIS_ LPDDSURFACEDESC2) PURE;
  1858.     STDMETHOD(Initialize)(THIS_ LPDIRECTDRAW, LPDDSURFACEDESC2) PURE;
  1859.     STDMETHOD(IsLost)(THIS) PURE;
  1860.     STDMETHOD(Lock)(THIS_ LPRECT,LPDDSURFACEDESC2,DWORD,HANDLE) PURE;
  1861.     STDMETHOD(ReleaseDC)(THIS_ HDC) PURE;
  1862.     STDMETHOD(Restore)(THIS) PURE;
  1863.     STDMETHOD(SetClipper)(THIS_ LPDIRECTDRAWCLIPPER) PURE;
  1864.     STDMETHOD(SetColorKey)(THIS_ DWORD, LPDDCOLORKEY) PURE;
  1865.     STDMETHOD(SetOverlayPosition)(THIS_ LONG, LONG ) PURE;
  1866.     STDMETHOD(SetPalette)(THIS_ LPDIRECTDRAWPALETTE) PURE;
  1867.     STDMETHOD(Unlock)(THIS_ LPRECT) PURE;
  1868.     STDMETHOD(UpdateOverlay)(THIS_ LPRECT, LPDIRECTDRAWSURFACE4,LPRECT,DWORD, LPDDOVERLAYFX) PURE;
  1869.     STDMETHOD(UpdateOverlayDisplay)(THIS_ DWORD) PURE;
  1870.     STDMETHOD(UpdateOverlayZOrder)(THIS_ DWORD, LPDIRECTDRAWSURFACE4) PURE;
  1871.     /*** Added in the v2 interface ***/
  1872.     STDMETHOD(GetDDInterface)(THIS_ LPVOID FAR *) PURE;
  1873.     STDMETHOD(PageLock)(THIS_ DWORD) PURE;
  1874.     STDMETHOD(PageUnlock)(THIS_ DWORD) PURE;
  1875.     /*** Added in the v3 interface ***/
  1876.     STDMETHOD(SetSurfaceDesc)(THIS_ LPDDSURFACEDESC2, DWORD) PURE;
  1877.     /*** Added in the v4 interface ***/
  1878.     STDMETHOD(SetPrivateData)(THIS_ REFGUID, LPVOID, DWORD, DWORD) PURE;
  1879.     STDMETHOD(GetPrivateData)(THIS_ REFGUID, LPVOID, LPDWORD) PURE;
  1880.     STDMETHOD(FreePrivateData)(THIS_ REFGUID) PURE;
  1881.     STDMETHOD(GetUniquenessValue)(THIS_ LPDWORD) PURE;
  1882.     STDMETHOD(ChangeUniquenessValue)(THIS) PURE;
  1883. };
  1884.  
  1885. #if !defined(__cplusplus) || defined(CINTERFACE)
  1886. #define IDirectDrawSurface4_QueryInterface(p,a,b)        (p)->lpVtbl->QueryInterface(p,a,b)
  1887. #define IDirectDrawSurface4_AddRef(p)                    (p)->lpVtbl->AddRef(p)
  1888. #define IDirectDrawSurface4_Release(p)                   (p)->lpVtbl->Release(p)
  1889. #define IDirectDrawSurface4_AddAttachedSurface(p,a)      (p)->lpVtbl->AddAttachedSurface(p,a)
  1890. #define IDirectDrawSurface4_AddOverlayDirtyRect(p,a)     (p)->lpVtbl->AddOverlayDirtyRect(p,a)
  1891. #define IDirectDrawSurface4_Blt(p,a,b,c,d,e)             (p)->lpVtbl->Blt(p,a,b,c,d,e)
  1892. #define IDirectDrawSurface4_BltBatch(p,a,b,c)            (p)->lpVtbl->BltBatch(p,a,b,c)
  1893. #define IDirectDrawSurface4_BltFast(p,a,b,c,d,e)         (p)->lpVtbl->BltFast(p,a,b,c,d,e)
  1894. #define IDirectDrawSurface4_DeleteAttachedSurface(p,a,b) (p)->lpVtbl->DeleteAttachedSurface(p,a,b)
  1895. #define IDirectDrawSurface4_EnumAttachedSurfaces(p,a,b)  (p)->lpVtbl->EnumAttachedSurfaces(p,a,b)
  1896. #define IDirectDrawSurface4_EnumOverlayZOrders(p,a,b,c)  (p)->lpVtbl->EnumOverlayZOrders(p,a,b,c)
  1897. #define IDirectDrawSurface4_Flip(p,a,b)                  (p)->lpVtbl->Flip(p,a,b)
  1898. #define IDirectDrawSurface4_GetAttachedSurface(p,a,b)    (p)->lpVtbl->GetAttachedSurface(p,a,b)
  1899. #define IDirectDrawSurface4_GetBltStatus(p,a)            (p)->lpVtbl->GetBltStatus(p,a)
  1900. #define IDirectDrawSurface4_GetCaps(p,b)                 (p)->lpVtbl->GetCaps(p,b)
  1901. #define IDirectDrawSurface4_GetClipper(p,a)              (p)->lpVtbl->GetClipper(p,a)
  1902. #define IDirectDrawSurface4_GetColorKey(p,a,b)           (p)->lpVtbl->GetColorKey(p,a,b)
  1903. #define IDirectDrawSurface4_GetDC(p,a)                   (p)->lpVtbl->GetDC(p,a)
  1904. #define IDirectDrawSurface4_GetFlipStatus(p,a)           (p)->lpVtbl->GetFlipStatus(p,a)
  1905. #define IDirectDrawSurface4_GetOverlayPosition(p,a,b)    (p)->lpVtbl->GetOverlayPosition(p,a,b)
  1906. #define IDirectDrawSurface4_GetPalette(p,a)              (p)->lpVtbl->GetPalette(p,a)
  1907. #define IDirectDrawSurface4_GetPixelFormat(p,a)          (p)->lpVtbl->GetPixelFormat(p,a)
  1908. #define IDirectDrawSurface4_GetSurfaceDesc(p,a)          (p)->lpVtbl->GetSurfaceDesc(p,a)
  1909. #define IDirectDrawSurface4_Initialize(p,a,b)            (p)->lpVtbl->Initialize(p,a,b)
  1910. #define IDirectDrawSurface4_IsLost(p)                    (p)->lpVtbl->IsLost(p)
  1911. #define IDirectDrawSurface4_Lock(p,a,b,c,d)              (p)->lpVtbl->Lock(p,a,b,c,d)
  1912. #define IDirectDrawSurface4_ReleaseDC(p,a)               (p)->lpVtbl->ReleaseDC(p,a)
  1913. #define IDirectDrawSurface4_Restore(p)                   (p)->lpVtbl->Restore(p)
  1914. #define IDirectDrawSurface4_SetClipper(p,a)              (p)->lpVtbl->SetClipper(p,a)
  1915. #define IDirectDrawSurface4_SetColorKey(p,a,b)           (p)->lpVtbl->SetColorKey(p,a,b)
  1916. #define IDirectDrawSurface4_SetOverlayPosition(p,a,b)    (p)->lpVtbl->SetOverlayPosition(p,a,b)
  1917. #define IDirectDrawSurface4_SetPalette(p,a)              (p)->lpVtbl->SetPalette(p,a)
  1918. #define IDirectDrawSurface4_Unlock(p,b)                  (p)->lpVtbl->Unlock(p,b)
  1919. #define IDirectDrawSurface4_UpdateOverlay(p,a,b,c,d,e)   (p)->lpVtbl->UpdateOverlay(p,a,b,c,d,e)
  1920. #define IDirectDrawSurface4_UpdateOverlayDisplay(p,a)    (p)->lpVtbl->UpdateOverlayDisplay(p,a)
  1921. #define IDirectDrawSurface4_UpdateOverlayZOrder(p,a,b)   (p)->lpVtbl->UpdateOverlayZOrder(p,a,b)
  1922. #define IDirectDrawSurface4_GetDDInterface(p,a)          (p)->lpVtbl->GetDDInterface(p,a)
  1923. #define IDirectDrawSurface4_PageLock(p,a)                (p)->lpVtbl->PageLock(p,a)
  1924. #define IDirectDrawSurface4_PageUnlock(p,a)              (p)->lpVtbl->PageUnlock(p,a)
  1925. #define IDirectDrawSurface4_SetSurfaceDesc(p,a,b)        (p)->lpVtbl->SetSurfaceDesc(p,a,b)
  1926. #define IDirectDrawSurface4_SetPrivateData(p,a,b,c,d)    (p)->lpVtbl->SetPrivateData(p,a,b,c,d)
  1927. #define IDirectDrawSurface4_GetPrivateData(p,a,b,c)      (p)->lpVtbl->GetPrivateData(p,a,b,c)
  1928. #define IDirectDrawSurface4_FreePrivateData(p,a)         (p)->lpVtbl->FreePrivateData(p,a)
  1929. #define IDirectDrawSurface4_GetUniquenessValue(p, a)     (p)->lpVtbl->GetUniquenessValue(p, a)
  1930. #define IDirectDrawSurface4_ChangeUniquenessValue(p)     (p)->lpVtbl->ChangeUniquenessValue(p)
  1931. #else
  1932. #define IDirectDrawSurface4_QueryInterface(p,a,b)        (p)->QueryInterface(a,b)
  1933. #define IDirectDrawSurface4_AddRef(p)                    (p)->AddRef()
  1934. #define IDirectDrawSurface4_Release(p)                   (p)->Release()
  1935. #define IDirectDrawSurface4_AddAttachedSurface(p,a)      (p)->AddAttachedSurface(a)
  1936. #define IDirectDrawSurface4_AddOverlayDirtyRect(p,a)     (p)->AddOverlayDirtyRect(a)
  1937. #define IDirectDrawSurface4_Blt(p,a,b,c,d,e)             (p)->Blt(a,b,c,d,e)
  1938. #define IDirectDrawSurface4_BltBatch(p,a,b,c)            (p)->BltBatch(a,b,c)
  1939. #define IDirectDrawSurface4_BltFast(p,a,b,c,d,e)         (p)->BltFast(a,b,c,d,e)
  1940. #define IDirectDrawSurface4_DeleteAttachedSurface(p,a,b) (p)->DeleteAttachedSurface(a,b)
  1941. #define IDirectDrawSurface4_EnumAttachedSurfaces(p,a,b)  (p)->EnumAttachedSurfaces(a,b)
  1942. #define IDirectDrawSurface4_EnumOverlayZOrders(p,a,b,c)  (p)->EnumOverlayZOrders(a,b,c)
  1943. #define IDirectDrawSurface4_Flip(p,a,b)                  (p)->Flip(a,b)
  1944. #define IDirectDrawSurface4_GetAttachedSurface(p,a,b)    (p)->GetAttachedSurface(a,b)
  1945. #define IDirectDrawSurface4_GetBltStatus(p,a)            (p)->GetBltStatus(a)
  1946. #define IDirectDrawSurface4_GetCaps(p,b)                 (p)->GetCaps(b)
  1947. #define IDirectDrawSurface4_GetClipper(p,a)              (p)->GetClipper(a)
  1948. #define IDirectDrawSurface4_GetColorKey(p,a,b)           (p)->GetColorKey(a,b)
  1949. #define IDirectDrawSurface4_GetDC(p,a)                   (p)->GetDC(a)
  1950. #define IDirectDrawSurface4_GetFlipStatus(p,a)           (p)->GetFlipStatus(a)
  1951. #define IDirectDrawSurface4_GetOverlayPosition(p,a,b)    (p)->GetOverlayPosition(a,b)
  1952. #define IDirectDrawSurface4_GetPalette(p,a)              (p)->GetPalette(a)
  1953. #define IDirectDrawSurface4_GetPixelFormat(p,a)          (p)->GetPixelFormat(a)
  1954. #define IDirectDrawSurface4_GetSurfaceDesc(p,a)          (p)->GetSurfaceDesc(a)
  1955. #define IDirectDrawSurface4_Initialize(p,a,b)            (p)->Initialize(a,b)
  1956. #define IDirectDrawSurface4_IsLost(p)                    (p)->IsLost()
  1957. #define IDirectDrawSurface4_Lock(p,a,b,c,d)              (p)->Lock(a,b,c,d)
  1958. #define IDirectDrawSurface4_ReleaseDC(p,a)               (p)->ReleaseDC(a)
  1959. #define IDirectDrawSurface4_Restore(p)                   (p)->Restore()
  1960. #define IDirectDrawSurface4_SetClipper(p,a)              (p)->SetClipper(a)
  1961. #define IDirectDrawSurface4_SetColorKey(p,a,b)           (p)->SetColorKey(a,b)
  1962. #define IDirectDrawSurface4_SetOverlayPosition(p,a,b)    (p)->SetOverlayPosition(a,b)
  1963. #define IDirectDrawSurface4_SetPalette(p,a)              (p)->SetPalette(a)
  1964. #define IDirectDrawSurface4_Unlock(p,b)                  (p)->Unlock(b)
  1965. #define IDirectDrawSurface4_UpdateOverlay(p,a,b,c,d,e)   (p)->UpdateOverlay(a,b,c,d,e)
  1966. #define IDirectDrawSurface4_UpdateOverlayDisplay(p,a)    (p)->UpdateOverlayDisplay(a)
  1967. #define IDirectDrawSurface4_UpdateOverlayZOrder(p,a,b)   (p)->UpdateOverlayZOrder(a,b)
  1968. #define IDirectDrawSurface4_GetDDInterface(p,a)          (p)->GetDDInterface(a)
  1969. #define IDirectDrawSurface4_PageLock(p,a)                (p)->PageLock(a)
  1970. #define IDirectDrawSurface4_PageUnlock(p,a)              (p)->PageUnlock(a)
  1971. #define IDirectDrawSurface4_SetSurfaceDesc(p,a,b)        (p)->SetSurfaceDesc(a,b)
  1972. #define IDirectDrawSurface4_SetPrivateData(p,a,b,c,d)    (p)->SetPrivateData(a,b,c,d)
  1973. #define IDirectDrawSurface4_GetPrivateData(p,a,b,c)      (p)->GetPrivateData(a,b,c)
  1974. #define IDirectDrawSurface4_FreePrivateData(p,a)         (p)->FreePrivateData(a)
  1975. #define IDirectDrawSurface4_GetUniquenessValue(p, a)     (p)->GetUniquenessValue(a)
  1976. #define IDirectDrawSurface4_ChangeUniquenessValue(p)     (p)->ChangeUniquenessValue()
  1977. #endif
  1978.  
  1979. /*
  1980.  * IDirectDrawSurface7 and related interfaces
  1981.  */
  1982. #undef INTERFACE
  1983. #define INTERFACE IDirectDrawSurface7
  1984. DECLARE_INTERFACE_( IDirectDrawSurface7, IUnknown )
  1985. {
  1986.     /*** IUnknown methods ***/
  1987.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE;
  1988.     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
  1989.     STDMETHOD_(ULONG,Release) (THIS) PURE;
  1990.     /*** IDirectDrawSurface methods ***/
  1991.     STDMETHOD(AddAttachedSurface)(THIS_ LPDIRECTDRAWSURFACE7) PURE;
  1992.     STDMETHOD(AddOverlayDirtyRect)(THIS_ LPRECT) PURE;
  1993.     STDMETHOD(Blt)(THIS_ LPRECT,LPDIRECTDRAWSURFACE7, LPRECT,DWORD, LPDDBLTFX) PURE;
  1994.     STDMETHOD(BltBatch)(THIS_ LPDDBLTBATCH, DWORD, DWORD ) PURE;
  1995.     STDMETHOD(BltFast)(THIS_ DWORD,DWORD,LPDIRECTDRAWSURFACE7, LPRECT,DWORD) PURE;
  1996.     STDMETHOD(DeleteAttachedSurface)(THIS_ DWORD,LPDIRECTDRAWSURFACE7) PURE;
  1997.     STDMETHOD(EnumAttachedSurfaces)(THIS_ LPVOID,LPDDENUMSURFACESCALLBACK7) PURE;
  1998.     STDMETHOD(EnumOverlayZOrders)(THIS_ DWORD,LPVOID,LPDDENUMSURFACESCALLBACK7) PURE;
  1999.     STDMETHOD(Flip)(THIS_ LPDIRECTDRAWSURFACE7, DWORD) PURE;
  2000.     STDMETHOD(GetAttachedSurface)(THIS_ LPDDSCAPS2, LPDIRECTDRAWSURFACE7 FAR *) PURE;
  2001.     STDMETHOD(GetBltStatus)(THIS_ DWORD) PURE;
  2002.     STDMETHOD(GetCaps)(THIS_ LPDDSCAPS2) PURE;
  2003.     STDMETHOD(GetClipper)(THIS_ LPDIRECTDRAWCLIPPER FAR*) PURE;
  2004.     STDMETHOD(GetColorKey)(THIS_ DWORD, LPDDCOLORKEY) PURE;
  2005.     STDMETHOD(GetDC)(THIS_ HDC FAR *) PURE;
  2006.     STDMETHOD(GetFlipStatus)(THIS_ DWORD) PURE;
  2007.     STDMETHOD(GetOverlayPosition)(THIS_ LPLONG, LPLONG ) PURE;
  2008.     STDMETHOD(GetPalette)(THIS_ LPDIRECTDRAWPALETTE FAR*) PURE;
  2009.     STDMETHOD(GetPixelFormat)(THIS_ LPDDPIXELFORMAT) PURE;
  2010.     STDMETHOD(GetSurfaceDesc)(THIS_ LPDDSURFACEDESC2) PURE;
  2011.     STDMETHOD(Initialize)(THIS_ LPDIRECTDRAW, LPDDSURFACEDESC2) PURE;
  2012.     STDMETHOD(IsLost)(THIS) PURE;
  2013.     STDMETHOD(Lock)(THIS_ LPRECT,LPDDSURFACEDESC2,DWORD,HANDLE) PURE;
  2014.     STDMETHOD(ReleaseDC)(THIS_ HDC) PURE;
  2015.     STDMETHOD(Restore)(THIS) PURE;
  2016.     STDMETHOD(SetClipper)(THIS_ LPDIRECTDRAWCLIPPER) PURE;
  2017.     STDMETHOD(SetColorKey)(THIS_ DWORD, LPDDCOLORKEY) PURE;
  2018.     STDMETHOD(SetOverlayPosition)(THIS_ LONG, LONG ) PURE;
  2019.     STDMETHOD(SetPalette)(THIS_ LPDIRECTDRAWPALETTE) PURE;
  2020.     STDMETHOD(Unlock)(THIS_ LPRECT) PURE;
  2021.     STDMETHOD(UpdateOverlay)(THIS_ LPRECT, LPDIRECTDRAWSURFACE7,LPRECT,DWORD, LPDDOVERLAYFX) PURE;
  2022.     STDMETHOD(UpdateOverlayDisplay)(THIS_ DWORD) PURE;
  2023.     STDMETHOD(UpdateOverlayZOrder)(THIS_ DWORD, LPDIRECTDRAWSURFACE7) PURE;
  2024.     /*** Added in the v2 interface ***/
  2025.     STDMETHOD(GetDDInterface)(THIS_ LPVOID FAR *) PURE;
  2026.     STDMETHOD(PageLock)(THIS_ DWORD) PURE;
  2027.     STDMETHOD(PageUnlock)(THIS_ DWORD) PURE;
  2028.     /*** Added in the v3 interface ***/
  2029.     STDMETHOD(SetSurfaceDesc)(THIS_ LPDDSURFACEDESC2, DWORD) PURE;
  2030.     /*** Added in the v4 interface ***/
  2031.     STDMETHOD(SetPrivateData)(THIS_ REFGUID, LPVOID, DWORD, DWORD) PURE;
  2032.     STDMETHOD(GetPrivateData)(THIS_ REFGUID, LPVOID, LPDWORD) PURE;
  2033.     STDMETHOD(FreePrivateData)(THIS_ REFGUID) PURE;
  2034.     STDMETHOD(GetUniquenessValue)(THIS_ LPDWORD) PURE;
  2035.     STDMETHOD(ChangeUniquenessValue)(THIS) PURE;
  2036.     /*** Moved Texture7 methods here ***/
  2037.     STDMETHOD(SetPriority)(THIS_ DWORD) PURE;
  2038.     STDMETHOD(GetPriority)(THIS_ LPDWORD) PURE;
  2039.     STDMETHOD(SetLOD)(THIS_ DWORD) PURE;
  2040.     STDMETHOD(GetLOD)(THIS_ LPDWORD) PURE;
  2041. };
  2042.  
  2043. #if !defined(__cplusplus) || defined(CINTERFACE)
  2044. #define IDirectDrawSurface7_QueryInterface(p,a,b)        (p)->lpVtbl->QueryInterface(p,a,b)
  2045. #define IDirectDrawSurface7_AddRef(p)                    (p)->lpVtbl->AddRef(p)
  2046. #define IDirectDrawSurface7_Release(p)                   (p)->lpVtbl->Release(p)
  2047. #define IDirectDrawSurface7_AddAttachedSurface(p,a)      (p)->lpVtbl->AddAttachedSurface(p,a)
  2048. #define IDirectDrawSurface7_AddOverlayDirtyRect(p,a)     (p)->lpVtbl->AddOverlayDirtyRect(p,a)
  2049. #define IDirectDrawSurface7_Blt(p,a,b,c,d,e)             (p)->lpVtbl->Blt(p,a,b,c,d,e)
  2050. #define IDirectDrawSurface7_BltBatch(p,a,b,c)            (p)->lpVtbl->BltBatch(p,a,b,c)
  2051. #define IDirectDrawSurface7_BltFast(p,a,b,c,d,e)         (p)->lpVtbl->BltFast(p,a,b,c,d,e)
  2052. #define IDirectDrawSurface7_DeleteAttachedSurface(p,a,b) (p)->lpVtbl->DeleteAttachedSurface(p,a,b)
  2053. #define IDirectDrawSurface7_EnumAttachedSurfaces(p,a,b)  (p)->lpVtbl->EnumAttachedSurfaces(p,a,b)
  2054. #define IDirectDrawSurface7_EnumOverlayZOrders(p,a,b,c)  (p)->lpVtbl->EnumOverlayZOrders(p,a,b,c)
  2055. #define IDirectDrawSurface7_Flip(p,a,b)                  (p)->lpVtbl->Flip(p,a,b)
  2056. #define IDirectDrawSurface7_GetAttachedSurface(p,a,b)    (p)->lpVtbl->GetAttachedSurface(p,a,b)
  2057. #define IDirectDrawSurface7_GetBltStatus(p,a)            (p)->lpVtbl->GetBltStatus(p,a)
  2058. #define IDirectDrawSurface7_GetCaps(p,b)                 (p)->lpVtbl->GetCaps(p,b)
  2059. #define IDirectDrawSurface7_GetClipper(p,a)              (p)->lpVtbl->GetClipper(p,a)
  2060. #define IDirectDrawSurface7_GetColorKey(p,a,b)           (p)->lpVtbl->GetColorKey(p,a,b)
  2061. #define IDirectDrawSurface7_GetDC(p,a)                   (p)->lpVtbl->GetDC(p,a)
  2062. #define IDirectDrawSurface7_GetFlipStatus(p,a)           (p)->lpVtbl->GetFlipStatus(p,a)
  2063. #define IDirectDrawSurface7_GetOverlayPosition(p,a,b)    (p)->lpVtbl->GetOverlayPosition(p,a,b)
  2064. #define IDirectDrawSurface7_GetPalette(p,a)              (p)->lpVtbl->GetPalette(p,a)
  2065. #define IDirectDrawSurface7_GetPixelFormat(p,a)          (p)->lpVtbl->GetPixelFormat(p,a)
  2066. #define IDirectDrawSurface7_GetSurfaceDesc(p,a)          (p)->lpVtbl->GetSurfaceDesc(p,a)
  2067. #define IDirectDrawSurface7_Initialize(p,a,b)            (p)->lpVtbl->Initialize(p,a,b)
  2068. #define IDirectDrawSurface7_IsLost(p)                    (p)->lpVtbl->IsLost(p)
  2069. #define IDirectDrawSurface7_Lock(p,a,b,c,d)              (p)->lpVtbl->Lock(p,a,b,c,d)
  2070. #define IDirectDrawSurface7_ReleaseDC(p,a)               (p)->lpVtbl->ReleaseDC(p,a)
  2071. #define IDirectDrawSurface7_Restore(p)                   (p)->lpVtbl->Restore(p)
  2072. #define IDirectDrawSurface7_SetClipper(p,a)              (p)->lpVtbl->SetClipper(p,a)
  2073. #define IDirectDrawSurface7_SetColorKey(p,a,b)           (p)->lpVtbl->SetColorKey(p,a,b)
  2074. #define IDirectDrawSurface7_SetOverlayPosition(p,a,b)    (p)->lpVtbl->SetOverlayPosition(p,a,b)
  2075. #define IDirectDrawSurface7_SetPalette(p,a)              (p)->lpVtbl->SetPalette(p,a)
  2076. #define IDirectDrawSurface7_Unlock(p,b)                  (p)->lpVtbl->Unlock(p,b)
  2077. #define IDirectDrawSurface7_UpdateOverlay(p,a,b,c,d,e)   (p)->lpVtbl->UpdateOverlay(p,a,b,c,d,e)
  2078. #define IDirectDrawSurface7_UpdateOverlayDisplay(p,a)    (p)->lpVtbl->UpdateOverlayDisplay(p,a)
  2079. #define IDirectDrawSurface7_UpdateOverlayZOrder(p,a,b)   (p)->lpVtbl->UpdateOverlayZOrder(p,a,b)
  2080. #define IDirectDrawSurface7_GetDDInterface(p,a)          (p)->lpVtbl->GetDDInterface(p,a)
  2081. #define IDirectDrawSurface7_PageLock(p,a)                (p)->lpVtbl->PageLock(p,a)
  2082. #define IDirectDrawSurface7_PageUnlock(p,a)              (p)->lpVtbl->PageUnlock(p,a)
  2083. #define IDirectDrawSurface7_SetSurfaceDesc(p,a,b)        (p)->lpVtbl->SetSurfaceDesc(p,a,b)
  2084. #define IDirectDrawSurface7_SetPrivateData(p,a,b,c,d)    (p)->lpVtbl->SetPrivateData(p,a,b,c,d)
  2085. #define IDirectDrawSurface7_GetPrivateData(p,a,b,c)      (p)->lpVtbl->GetPrivateData(p,a,b,c)
  2086. #define IDirectDrawSurface7_FreePrivateData(p,a)         (p)->lpVtbl->FreePrivateData(p,a)
  2087. #define IDirectDrawSurface7_GetUniquenessValue(p, a)     (p)->lpVtbl->GetUniquenessValue(p, a)
  2088. #define IDirectDrawSurface7_ChangeUniquenessValue(p)     (p)->lpVtbl->ChangeUniquenessValue(p)
  2089. #define IDirectDrawSurface7_SetPriority(p,a)             (p)->lpVtbl->SetPriority(p,a)
  2090. #define IDirectDrawSurface7_GetPriority(p,a)             (p)->lpVtbl->GetPriority(p,a)
  2091. #define IDirectDrawSurface7_SetLOD(p,a)                  (p)->lpVtbl->SetLOD(p,a)
  2092. #define IDirectDrawSurface7_GetLOD(p,a)                  (p)->lpVtbl->GetLOD(p,a)
  2093. #else
  2094. #define IDirectDrawSurface7_QueryInterface(p,a,b)        (p)->QueryInterface(a,b)
  2095. #define IDirectDrawSurface7_AddRef(p)                    (p)->AddRef()
  2096. #define IDirectDrawSurface7_Release(p)                   (p)->Release()
  2097. #define IDirectDrawSurface7_AddAttachedSurface(p,a)      (p)->AddAttachedSurface(a)
  2098. #define IDirectDrawSurface7_AddOverlayDirtyRect(p,a)     (p)->AddOverlayDirtyRect(a)
  2099. #define IDirectDrawSurface7_Blt(p,a,b,c,d,e)             (p)->Blt(a,b,c,d,e)
  2100. #define IDirectDrawSurface7_BltBatch(p,a,b,c)            (p)->BltBatch(a,b,c)
  2101. #define IDirectDrawSurface7_BltFast(p,a,b,c,d,e)         (p)->BltFast(a,b,c,d,e)
  2102. #define IDirectDrawSurface7_DeleteAttachedSurface(p,a,b) (p)->DeleteAttachedSurface(a,b)
  2103. #define IDirectDrawSurface7_EnumAttachedSurfaces(p,a,b)  (p)->EnumAttachedSurfaces(a,b)
  2104. #define IDirectDrawSurface7_EnumOverlayZOrders(p,a,b,c)  (p)->EnumOverlayZOrders(a,b,c)
  2105. #define IDirectDrawSurface7_Flip(p,a,b)                  (p)->Flip(a,b)
  2106. #define IDirectDrawSurface7_GetAttachedSurface(p,a,b)    (p)->GetAttachedSurface(a,b)
  2107. #define IDirectDrawSurface7_GetBltStatus(p,a)            (p)->GetBltStatus(a)
  2108. #define IDirectDrawSurface7_GetCaps(p,b)                 (p)->GetCaps(b)
  2109. #define IDirectDrawSurface7_GetClipper(p,a)              (p)->GetClipper(a)
  2110. #define IDirectDrawSurface7_GetColorKey(p,a,b)           (p)->GetColorKey(a,b)
  2111. #define IDirectDrawSurface7_GetDC(p,a)                   (p)->GetDC(a)
  2112. #define IDirectDrawSurface7_GetFlipStatus(p,a)           (p)->GetFlipStatus(a)
  2113. #define IDirectDrawSurface7_GetOverlayPosition(p,a,b)    (p)->GetOverlayPosition(a,b)
  2114. #define IDirectDrawSurface7_GetPalette(p,a)              (p)->GetPalette(a)
  2115. #define IDirectDrawSurface7_GetPixelFormat(p,a)          (p)->GetPixelFormat(a)
  2116. #define IDirectDrawSurface7_GetSurfaceDesc(p,a)          (p)->GetSurfaceDesc(a)
  2117. #define IDirectDrawSurface7_Initialize(p,a,b)            (p)->Initialize(a,b)
  2118. #define IDirectDrawSurface7_IsLost(p)                    (p)->IsLost()
  2119. #define IDirectDrawSurface7_Lock(p,a,b,c,d)              (p)->Lock(a,b,c,d)
  2120. #define IDirectDrawSurface7_ReleaseDC(p,a)               (p)->ReleaseDC(a)
  2121. #define IDirectDrawSurface7_Restore(p)                   (p)->Restore()
  2122. #define IDirectDrawSurface7_SetClipper(p,a)              (p)->SetClipper(a)
  2123. #define IDirectDrawSurface7_SetColorKey(p,a,b)           (p)->SetColorKey(a,b)
  2124. #define IDirectDrawSurface7_SetOverlayPosition(p,a,b)    (p)->SetOverlayPosition(a,b)
  2125. #define IDirectDrawSurface7_SetPalette(p,a)              (p)->SetPalette(a)
  2126. #define IDirectDrawSurface7_Unlock(p,b)                  (p)->Unlock(b)
  2127. #define IDirectDrawSurface7_UpdateOverlay(p,a,b,c,d,e)   (p)->UpdateOverlay(a,b,c,d,e)
  2128. #define IDirectDrawSurface7_UpdateOverlayDisplay(p,a)    (p)->UpdateOverlayDisplay(a)
  2129. #define IDirectDrawSurface7_UpdateOverlayZOrder(p,a,b)   (p)->UpdateOverlayZOrder(a,b)
  2130. #define IDirectDrawSurface7_GetDDInterface(p,a)          (p)->GetDDInterface(a)
  2131. #define IDirectDrawSurface7_PageLock(p,a)                (p)->PageLock(a)
  2132. #define IDirectDrawSurface7_PageUnlock(p,a)              (p)->PageUnlock(a)
  2133. #define IDirectDrawSurface7_SetSurfaceDesc(p,a,b)        (p)->SetSurfaceDesc(a,b)
  2134. #define IDirectDrawSurface7_SetPrivateData(p,a,b,c,d)    (p)->SetPrivateData(a,b,c,d)
  2135. #define IDirectDrawSurface7_GetPrivateData(p,a,b,c)      (p)->GetPrivateData(a,b,c)
  2136. #define IDirectDrawSurface7_FreePrivateData(p,a)         (p)->FreePrivateData(a)
  2137. #define IDirectDrawSurface7_GetUniquenessValue(p, a)     (p)->GetUniquenessValue(a)
  2138. #define IDirectDrawSurface7_ChangeUniquenessValue(p)     (p)->ChangeUniquenessValue()
  2139. #define IDirectDrawSurface7_SetPriority(p,a)             (p)->SetPriority(a)
  2140. #define IDirectDrawSurface7_GetPriority(p,a)             (p)->GetPriority(a)
  2141. #define IDirectDrawSurface7_SetLOD(p,a)                  (p)->SetLOD(a)
  2142. #define IDirectDrawSurface7_GetLOD(p,a)                  (p)->GetLOD(a)
  2143. #endif
  2144.  
  2145.  
  2146. /*
  2147.  * IDirectDrawColorControl
  2148.  */
  2149. #if defined( _WIN32 ) && !defined( _NO_COM )
  2150. #undef INTERFACE
  2151. #define INTERFACE IDirectDrawColorControl
  2152. DECLARE_INTERFACE_( IDirectDrawColorControl, IUnknown )
  2153. {
  2154.     /*** IUnknown methods ***/
  2155.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE;
  2156.     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
  2157.     STDMETHOD_(ULONG,Release) (THIS) PURE;
  2158.     /*** IDirectDrawColorControl methods ***/
  2159.     STDMETHOD(GetColorControls)(THIS_ LPDDCOLORCONTROL) PURE;
  2160.     STDMETHOD(SetColorControls)(THIS_ LPDDCOLORCONTROL) PURE;
  2161. };
  2162.  
  2163. #if !defined(__cplusplus) || defined(CINTERFACE)
  2164. #define IDirectDrawColorControl_QueryInterface(p, a, b)  (p)->lpVtbl->QueryInterface(p, a, b)
  2165. #define IDirectDrawColorControl_AddRef(p)                (p)->lpVtbl->AddRef(p)
  2166. #define IDirectDrawColorControl_Release(p)               (p)->lpVtbl->Release(p)
  2167. #define IDirectDrawColorControl_GetColorControls(p, a)   (p)->lpVtbl->GetColorControls(p, a)
  2168. #define IDirectDrawColorControl_SetColorControls(p, a)   (p)->lpVtbl->SetColorControls(p, a)
  2169. #else
  2170. #define IDirectDrawColorControl_QueryInterface(p, a, b)  (p)->QueryInterface(a, b)
  2171. #define IDirectDrawColorControl_AddRef(p)                (p)->AddRef()
  2172. #define IDirectDrawColorControl_Release(p)               (p)->Release()
  2173. #define IDirectDrawColorControl_GetColorControls(p, a)   (p)->GetColorControls(a)
  2174. #define IDirectDrawColorControl_SetColorControls(p, a)   (p)->SetColorControls(a)
  2175. #endif
  2176.  
  2177. #endif
  2178.  
  2179.  
  2180. /*
  2181.  * IDirectDrawGammaControl
  2182.  */
  2183. #if defined( _WIN32 ) && !defined( _NO_COM )
  2184. #undef INTERFACE
  2185. #define INTERFACE IDirectDrawGammaControl
  2186. DECLARE_INTERFACE_( IDirectDrawGammaControl, IUnknown )
  2187. {
  2188.     /*** IUnknown methods ***/
  2189.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE;
  2190.     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
  2191.     STDMETHOD_(ULONG,Release) (THIS) PURE;
  2192.     /*** IDirectDrawGammaControl methods ***/
  2193.     STDMETHOD(GetGammaRamp)(THIS_ DWORD, LPDDGAMMARAMP) PURE;
  2194.     STDMETHOD(SetGammaRamp)(THIS_ DWORD, LPDDGAMMARAMP) PURE;
  2195. };
  2196.  
  2197. #if !defined(__cplusplus) || defined(CINTERFACE)
  2198. #define IDirectDrawGammaControl_QueryInterface(p, a, b)  (p)->lpVtbl->QueryInterface(p, a, b)
  2199. #define IDirectDrawGammaControl_AddRef(p)                (p)->lpVtbl->AddRef(p)
  2200. #define IDirectDrawGammaControl_Release(p)               (p)->lpVtbl->Release(p)
  2201. #define IDirectDrawGammaControl_GetGammaRamp(p, a, b)    (p)->lpVtbl->GetGammaRamp(p, a, b)
  2202. #define IDirectDrawGammaControl_SetGammaRamp(p, a, b)    (p)->lpVtbl->SetGammaRamp(p, a, b)
  2203. #else
  2204. #define IDirectDrawGammaControl_QueryInterface(p, a, b)  (p)->QueryInterface(a, b)
  2205. #define IDirectDrawGammaControl_AddRef(p)                (p)->AddRef()
  2206. #define IDirectDrawGammaControl_Release(p)               (p)->Release()
  2207. #define IDirectDrawGammaControl_GetGammaRamp(p, a, b)    (p)->GetGammaRamp(a, b)
  2208. #define IDirectDrawGammaControl_SetGammaRamp(p, a, b)    (p)->SetGammaRamp(a, b)
  2209. #endif
  2210.  
  2211. #endif
  2212.  
  2213.  
  2214.  
  2215. #endif
  2216.  
  2217.  
  2218. /*
  2219.  * DDSURFACEDESC
  2220.  */
  2221. typedef struct _DDSURFACEDESC
  2222. {
  2223.     DWORD               dwSize;                 // size of the DDSURFACEDESC structure
  2224.     DWORD               dwFlags;                // determines what fields are valid
  2225.     DWORD               dwHeight;               // height of surface to be created
  2226.     DWORD               dwWidth;                // width of input surface
  2227.     union
  2228.     {
  2229.         LONG            lPitch;                 // distance to start of next line (return value only)
  2230.         DWORD           dwLinearSize;           // Formless late-allocated optimized surface size
  2231.     } DUMMYUNIONNAMEN(1);
  2232.     DWORD               dwBackBufferCount;      // number of back buffers requested
  2233.     union
  2234.     {
  2235.         DWORD           dwMipMapCount;          // number of mip-map levels requested
  2236.         DWORD           dwZBufferBitDepth;      // depth of Z buffer requested
  2237.         DWORD           dwRefreshRate;          // refresh rate (used when display mode is described)
  2238.     } DUMMYUNIONNAMEN(2);
  2239.     DWORD               dwAlphaBitDepth;        // depth of alpha buffer requested
  2240.     DWORD               dwReserved;             // reserved
  2241.     LPVOID              lpSurface;              // pointer to the associated surface memory
  2242.     DDCOLORKEY          ddckCKDestOverlay;      // color key for destination overlay use
  2243.     DDCOLORKEY          ddckCKDestBlt;          // color key for destination blt use
  2244.     DDCOLORKEY          ddckCKSrcOverlay;       // color key for source overlay use
  2245.     DDCOLORKEY          ddckCKSrcBlt;           // color key for source blt use
  2246.     DDPIXELFORMAT       ddpfPixelFormat;        // pixel format description of the surface
  2247.     DDSCAPS             ddsCaps;                // direct draw surface capabilities
  2248. } DDSURFACEDESC;
  2249.  
  2250. /*
  2251.  * DDSURFACEDESC2
  2252.  */
  2253. typedef struct _DDSURFACEDESC2
  2254. {
  2255.     DWORD               dwSize;                 // size of the DDSURFACEDESC structure
  2256.     DWORD               dwFlags;                // determines what fields are valid
  2257.     DWORD               dwHeight;               // height of surface to be created
  2258.     DWORD               dwWidth;                // width of input surface
  2259.     union
  2260.     {
  2261.         LONG            lPitch;                 // distance to start of next line (return value only)
  2262.         DWORD           dwLinearSize;           // Formless late-allocated optimized surface size
  2263.     } DUMMYUNIONNAMEN(1);
  2264.     union
  2265.     {
  2266.         DWORD           dwBackBufferCount;      // number of back buffers requested
  2267.         DWORD           dwDepth;                // the depth if this is a volume texture 
  2268.     } DUMMYUNIONNAMEN(5);
  2269.     union
  2270.     {
  2271.         DWORD           dwMipMapCount;          // number of mip-map levels requestde
  2272.                                                 // dwZBufferBitDepth removed, use ddpfPixelFormat one instead
  2273.         DWORD           dwRefreshRate;          // refresh rate (used when display mode is described)
  2274.         DWORD           dwSrcVBHandle;          // The source used in VB::Optimize
  2275.     } DUMMYUNIONNAMEN(2);
  2276.     DWORD               dwAlphaBitDepth;        // depth of alpha buffer requested
  2277.     DWORD               dwReserved;             // reserved
  2278.     LPVOID              lpSurface;              // pointer to the associated surface memory
  2279.     union
  2280.     {
  2281.         DDCOLORKEY      ddckCKDestOverlay;      // color key for destination overlay use
  2282.         DWORD           dwEmptyFaceColor;       // Physical color for empty cubemap faces
  2283.     } DUMMYUNIONNAMEN(3);
  2284.     DDCOLORKEY          ddckCKDestBlt;          // color key for destination blt use
  2285.     DDCOLORKEY          ddckCKSrcOverlay;       // color key for source overlay use
  2286.     DDCOLORKEY          ddckCKSrcBlt;           // color key for source blt use
  2287.     union
  2288.     {
  2289.         DDPIXELFORMAT   ddpfPixelFormat;        // pixel format description of the surface
  2290.         DWORD           dwFVF;                  // vertex format description of vertex buffers
  2291.     } DUMMYUNIONNAMEN(4);
  2292.     DDSCAPS2            ddsCaps;                // direct draw surface capabilities
  2293.     DWORD               dwTextureStage;         // stage in multitexture cascade
  2294. } DDSURFACEDESC2;
  2295.  
  2296. /*
  2297.  * ddsCaps field is valid.
  2298.  */
  2299. #define DDSD_CAPS               0x00000001l     // default
  2300.  
  2301. /*
  2302.  * dwHeight field is valid.
  2303.  */
  2304. #define DDSD_HEIGHT             0x00000002l
  2305.  
  2306. /*
  2307.  * dwWidth field is valid.
  2308.  */
  2309. #define DDSD_WIDTH              0x00000004l
  2310.  
  2311. /*
  2312.  * lPitch is valid.
  2313.  */
  2314. #define DDSD_PITCH              0x00000008l
  2315.  
  2316. /*
  2317.  * dwBackBufferCount is valid.
  2318.  */
  2319. #define DDSD_BACKBUFFERCOUNT    0x00000020l
  2320.  
  2321. /*
  2322.  * dwZBufferBitDepth is valid.  (shouldnt be used in DDSURFACEDESC2)
  2323.  */
  2324. #define DDSD_ZBUFFERBITDEPTH    0x00000040l
  2325.  
  2326. /*
  2327.  * dwAlphaBitDepth is valid.
  2328.  */
  2329. #define DDSD_ALPHABITDEPTH      0x00000080l
  2330.  
  2331.  
  2332. /*
  2333.  * lpSurface is valid.
  2334.  */
  2335. #define DDSD_LPSURFACE          0x00000800l
  2336.  
  2337. /*
  2338.  * ddpfPixelFormat is valid.
  2339.  */
  2340. #define DDSD_PIXELFORMAT        0x00001000l
  2341.  
  2342. /*
  2343.  * ddckCKDestOverlay is valid.
  2344.  */
  2345. #define DDSD_CKDESTOVERLAY      0x00002000l
  2346.  
  2347. /*
  2348.  * ddckCKDestBlt is valid.
  2349.  */
  2350. #define DDSD_CKDESTBLT          0x00004000l
  2351.  
  2352. /*
  2353.  * ddckCKSrcOverlay is valid.
  2354.  */
  2355. #define DDSD_CKSRCOVERLAY       0x00008000l
  2356.  
  2357. /*
  2358.  * ddckCKSrcBlt is valid.
  2359.  */
  2360. #define DDSD_CKSRCBLT           0x00010000l
  2361.  
  2362. /*
  2363.  * dwMipMapCount is valid.
  2364.  */
  2365. #define DDSD_MIPMAPCOUNT        0x00020000l
  2366.  
  2367.  /*
  2368.   * dwRefreshRate is valid
  2369.   */
  2370. #define DDSD_REFRESHRATE        0x00040000l
  2371.  
  2372. /*
  2373.  * dwLinearSize is valid
  2374.  */
  2375. #define DDSD_LINEARSIZE         0x00080000l
  2376.  
  2377. /*
  2378.  * dwTextureStage is valid
  2379.  */
  2380. #define DDSD_TEXTURESTAGE       0x00100000l
  2381. /*
  2382.  * dwFVF is valid
  2383.  */
  2384. #define DDSD_FVF                0x00200000l
  2385. /*
  2386.  * dwSrcVBHandle is valid
  2387.  */
  2388. #define DDSD_SRCVBHANDLE        0x00400000l
  2389.  
  2390. /*
  2391.  * dwDepth is valid
  2392.  */
  2393. #define DDSD_DEPTH              0x00800000l
  2394.  
  2395. /*
  2396.  * All input fields are valid.
  2397.  */
  2398. #define DDSD_ALL                0x00fff9eel
  2399.  
  2400. /*
  2401.  * DDOPTSURFACEDESC
  2402.  */
  2403. typedef struct _DDOPTSURFACEDESC
  2404. {
  2405.     DWORD       dwSize;             // size of the DDOPTSURFACEDESC structure
  2406.     DWORD       dwFlags;            // determines what fields are valid
  2407.     DDSCAPS2    ddSCaps;            // Common caps like: Memory type
  2408.     DDOSCAPS    ddOSCaps;           // Common caps like: Memory type
  2409.     GUID        guid;               // Compression technique GUID
  2410.     DWORD       dwCompressionRatio; // Compression ratio
  2411. } DDOPTSURFACEDESC;
  2412.  
  2413. /*
  2414.  * guid field is valid.
  2415.  */
  2416. #define DDOSD_GUID                  0x00000001l
  2417.  
  2418. /*
  2419.  * dwCompressionRatio field is valid.
  2420.  */
  2421. #define DDOSD_COMPRESSION_RATIO     0x00000002l
  2422.  
  2423. /*
  2424.  * ddSCaps field is valid.
  2425.  */
  2426. #define DDOSD_SCAPS                 0x00000004l
  2427.  
  2428. /*
  2429.  * ddOSCaps field is valid.
  2430.  */
  2431. #define DDOSD_OSCAPS                0x00000008l
  2432.  
  2433. /*
  2434.  * All input fields are valid.
  2435.  */
  2436. #define DDOSD_ALL                   0x0000000fl
  2437.  
  2438. /*
  2439.  * The surface's optimized pixelformat is compressed
  2440.  */
  2441. #define DDOSDCAPS_OPTCOMPRESSED                 0x00000001l
  2442.  
  2443. /*
  2444.  * The surface's optimized pixelformat is reordered
  2445.  */
  2446. #define DDOSDCAPS_OPTREORDERED                  0x00000002l
  2447.  
  2448. /*
  2449.  * The opt surface is a monolithic mipmap
  2450.  */
  2451. #define DDOSDCAPS_MONOLITHICMIPMAP              0x00000004l
  2452.  
  2453. /*
  2454.  * The valid Surf caps:
  2455.  * #define DDSCAPS_SYSTEMMEMORY                 0x00000800l
  2456.  * #define DDSCAPS_VIDEOMEMORY          0x00004000l
  2457.  * #define DDSCAPS_LOCALVIDMEM          0x10000000l
  2458.  * #define DDSCAPS_NONLOCALVIDMEM       0x20000000l
  2459.  */
  2460. #define DDOSDCAPS_VALIDSCAPS            0x30004800l
  2461.  
  2462. /*
  2463.  * The valid OptSurf caps
  2464.  */
  2465. #define DDOSDCAPS_VALIDOSCAPS           0x00000007l
  2466.  
  2467.  
  2468. /*
  2469.  * DDCOLORCONTROL
  2470.  */
  2471. typedef struct _DDCOLORCONTROL
  2472. {
  2473.     DWORD               dwSize;
  2474.     DWORD               dwFlags;
  2475.     LONG                lBrightness;
  2476.     LONG                lContrast;
  2477.     LONG                lHue;
  2478.     LONG                lSaturation;
  2479.     LONG                lSharpness;
  2480.     LONG                lGamma;
  2481.     LONG                lColorEnable;
  2482.     DWORD               dwReserved1;
  2483. } DDCOLORCONTROL;
  2484.  
  2485.  
  2486. /*
  2487.  * lBrightness field is valid.
  2488.  */
  2489. #define DDCOLOR_BRIGHTNESS              0x00000001l
  2490.  
  2491. /*
  2492.  * lContrast field is valid.
  2493.  */
  2494. #define DDCOLOR_CONTRAST                0x00000002l
  2495.  
  2496. /*
  2497.  * lHue field is valid.
  2498.  */
  2499. #define DDCOLOR_HUE                     0x00000004l
  2500.  
  2501. /*
  2502.  * lSaturation field is valid.
  2503.  */
  2504. #define DDCOLOR_SATURATION              0x00000008l
  2505.  
  2506. /*
  2507.  * lSharpness field is valid.
  2508.  */
  2509. #define DDCOLOR_SHARPNESS               0x00000010l
  2510.  
  2511. /*
  2512.  * lGamma field is valid.
  2513.  */
  2514. #define DDCOLOR_GAMMA                   0x00000020l
  2515.  
  2516. /*
  2517.  * lColorEnable field is valid.
  2518.  */
  2519. #define DDCOLOR_COLORENABLE             0x00000040l
  2520.  
  2521.  
  2522.  
  2523. /*============================================================================
  2524.  *
  2525.  * Direct Draw Capability Flags
  2526.  *
  2527.  * These flags are used to describe the capabilities of a given Surface.
  2528.  * All flags are bit flags.
  2529.  *
  2530.  *==========================================================================*/
  2531.  
  2532. /****************************************************************************
  2533.  *
  2534.  * DIRECTDRAWSURFACE CAPABILITY FLAGS
  2535.  *
  2536.  ****************************************************************************/
  2537.  
  2538. /*
  2539.  * This bit is reserved. It should not be specified.
  2540.  */
  2541. #define DDSCAPS_RESERVED1                       0x00000001l
  2542.  
  2543. /*
  2544.  * Indicates that this surface contains alpha-only information.
  2545.  * (To determine if a surface is RGBA/YUVA, the pixel format must be
  2546.  * interrogated.)
  2547.  */
  2548. #define DDSCAPS_ALPHA                           0x00000002l
  2549.  
  2550. /*
  2551.  * Indicates that this surface is a backbuffer.  It is generally
  2552.  * set by CreateSurface when the DDSCAPS_FLIP capability bit is set.
  2553.  * It indicates that this surface is THE back buffer of a surface
  2554.  * flipping structure.  DirectDraw supports N surfaces in a
  2555.  * surface flipping structure.  Only the surface that immediately
  2556.  * precedeces the DDSCAPS_FRONTBUFFER has this capability bit set.
  2557.  * The other surfaces are identified as back buffers by the presence
  2558.  * of the DDSCAPS_FLIP capability, their attachment order, and the
  2559.  * absence of the DDSCAPS_FRONTBUFFER and DDSCAPS_BACKBUFFER
  2560.  * capabilities.  The bit is sent to CreateSurface when a standalone
  2561.  * back buffer is being created.  This surface could be attached to
  2562.  * a front buffer and/or back buffers to form a flipping surface
  2563.  * structure after the CreateSurface call.  See AddAttachments for
  2564.  * a detailed description of the behaviors in this case.
  2565.  */
  2566. #define DDSCAPS_BACKBUFFER                      0x00000004l
  2567.  
  2568. /*
  2569.  * Indicates a complex surface structure is being described.  A
  2570.  * complex surface structure results in the creation of more than
  2571.  * one surface.  The additional surfaces are attached to the root
  2572.  * surface.  The complex structure can only be destroyed by
  2573.  * destroying the root.
  2574.  */
  2575. #define DDSCAPS_COMPLEX                         0x00000008l
  2576.  
  2577. /*
  2578.  * Indicates that this surface is a part of a surface flipping structure.
  2579.  * When it is passed to CreateSurface the DDSCAPS_FRONTBUFFER and
  2580.  * DDSCAP_BACKBUFFER bits are not set.  They are set by CreateSurface
  2581.  * on the resulting creations.  The dwBackBufferCount field in the
  2582.  * DDSURFACEDESC structure must be set to at least 1 in order for
  2583.  * the CreateSurface call to succeed.  The DDSCAPS_COMPLEX capability
  2584.  * must always be set with creating multiple surfaces through CreateSurface.
  2585.  */
  2586. #define DDSCAPS_FLIP                            0x00000010l
  2587.  
  2588. /*
  2589.  * Indicates that this surface is THE front buffer of a surface flipping
  2590.  * structure.  It is generally set by CreateSurface when the DDSCAPS_FLIP
  2591.  * capability bit is set.
  2592.  * If this capability is sent to CreateSurface then a standalonw front buffer
  2593.  * is created.  This surface will not have the DDSCAPS_FLIP capability.
  2594.  * It can be attached to other back buffers to form a flipping structure.
  2595.  * See AddAttachments for a detailed description of the behaviors in this
  2596.  * case.
  2597.  */
  2598. #define DDSCAPS_FRONTBUFFER                     0x00000020l
  2599.  
  2600. /*
  2601.  * Indicates that this surface is any offscreen surface that is not an overlay,
  2602.  * texture, zbuffer, front buffer, back buffer, or alpha surface.  It is used
  2603.  * to identify plain vanilla surfaces.
  2604.  */
  2605. #define DDSCAPS_OFFSCREENPLAIN                  0x00000040l
  2606.  
  2607. /*
  2608.  * Indicates that this surface is an overlay.  It may or may not be directly visible
  2609.  * depending on whether or not it is currently being overlayed onto the primary
  2610.  * surface.  DDSCAPS_VISIBLE can be used to determine whether or not it is being
  2611.  * overlayed at the moment.
  2612.  */
  2613. #define DDSCAPS_OVERLAY                         0x00000080l
  2614.  
  2615. /*
  2616.  * Indicates that unique DirectDrawPalette objects can be created and
  2617.  * attached to this surface.
  2618.  */
  2619. #define DDSCAPS_PALETTE                         0x00000100l
  2620.  
  2621. /*
  2622.  * Indicates that this surface is the primary surface.  The primary
  2623.  * surface represents what the user is seeing at the moment.
  2624.  */
  2625. #define DDSCAPS_PRIMARYSURFACE                  0x00000200l
  2626.  
  2627.  
  2628. /*
  2629.  * This flag used to be DDSCAPS_PRIMARYSURFACELEFT, which is now
  2630.  * obsolete.
  2631.  */
  2632. #define DDSCAPS_RESERVED3               0x00000400l
  2633. #define DDSCAPS_PRIMARYSURFACELEFT              0x00000000l
  2634.  
  2635. /*
  2636.  * Indicates that this surface memory was allocated in system memory
  2637.  */
  2638. #define DDSCAPS_SYSTEMMEMORY                    0x00000800l
  2639.  
  2640. /*
  2641.  * Indicates that this surface can be used as a 3D texture.  It does not
  2642.  * indicate whether or not the surface is being used for that purpose.
  2643.  */
  2644. #define DDSCAPS_TEXTURE                         0x00001000l
  2645.  
  2646. /*
  2647.  * Indicates that a surface may be a destination for 3D rendering.  This
  2648.  * bit must be set in order to query for a Direct3D Device Interface
  2649.  * from this surface.
  2650.  */
  2651. #define DDSCAPS_3DDEVICE                        0x00002000l
  2652.  
  2653. /*
  2654.  * Indicates that this surface exists in video memory.
  2655.  */
  2656. #define DDSCAPS_VIDEOMEMORY                     0x00004000l
  2657.  
  2658. /*
  2659.  * Indicates that changes made to this surface are immediately visible.
  2660.  * It is always set for the primary surface and is set for overlays while
  2661.  * they are being overlayed and texture maps while they are being textured.
  2662.  */
  2663. #define DDSCAPS_VISIBLE                         0x00008000l
  2664.  
  2665. /*
  2666.  * Indicates that only writes are permitted to the surface.  Read accesses
  2667.  * from the surface may or may not generate a protection fault, but the
  2668.  * results of a read from this surface will not be meaningful.  READ ONLY.
  2669.  */
  2670. #define DDSCAPS_WRITEONLY                       0x00010000l
  2671.  
  2672. /*
  2673.  * Indicates that this surface is a z buffer. A z buffer does not contain
  2674.  * displayable information.  Instead it contains bit depth information that is
  2675.  * used to determine which pixels are visible and which are obscured.
  2676.  */
  2677. #define DDSCAPS_ZBUFFER                         0x00020000l
  2678.  
  2679. /*
  2680.  * Indicates surface will have a DC associated long term
  2681.  */
  2682. #define DDSCAPS_OWNDC                           0x00040000l
  2683.  
  2684. /*
  2685.  * Indicates surface should be able to receive live video
  2686.  */
  2687. #define DDSCAPS_LIVEVIDEO                       0x00080000l
  2688.  
  2689. /*
  2690.  * Indicates surface should be able to have a stream decompressed
  2691.  * to it by the hardware.
  2692.  */
  2693. #define DDSCAPS_HWCODEC                         0x00100000l
  2694.  
  2695. /*
  2696.  * Surface is a ModeX surface.
  2697.  *
  2698.  */
  2699. #define DDSCAPS_MODEX                           0x00200000l
  2700.  
  2701. /*
  2702.  * Indicates surface is one level of a mip-map. This surface will
  2703.  * be attached to other DDSCAPS_MIPMAP surfaces to form the mip-map.
  2704.  * This can be done explicitly, by creating a number of surfaces and
  2705.  * attaching them with AddAttachedSurface or by implicitly by CreateSurface.
  2706.  * If this bit is set then DDSCAPS_TEXTURE must also be set.
  2707.  */
  2708. #define DDSCAPS_MIPMAP                          0x00400000l
  2709.  
  2710. /*
  2711.  * This bit is reserved. It should not be specified.
  2712.  */
  2713. #define DDSCAPS_RESERVED2                       0x00800000l
  2714.  
  2715.  
  2716. /*
  2717.  * Indicates that memory for the surface is not allocated until the surface
  2718.  * is loaded (via the Direct3D texture Load() function).
  2719.  */
  2720. #define DDSCAPS_ALLOCONLOAD                     0x04000000l
  2721.  
  2722. /*
  2723.  * Indicates that the surface will recieve data from a video port.
  2724.  */
  2725. #define DDSCAPS_VIDEOPORT                       0x08000000l
  2726.  
  2727. /*
  2728.  * Indicates that a video memory surface is resident in true, local video
  2729.  * memory rather than non-local video memory. If this flag is specified then
  2730.  * so must DDSCAPS_VIDEOMEMORY. This flag is mutually exclusive with
  2731.  * DDSCAPS_NONLOCALVIDMEM.
  2732.  */
  2733. #define DDSCAPS_LOCALVIDMEM                     0x10000000l
  2734.  
  2735. /*
  2736.  * Indicates that a video memory surface is resident in non-local video
  2737.  * memory rather than true, local video memory. If this flag is specified
  2738.  * then so must DDSCAPS_VIDEOMEMORY. This flag is mutually exclusive with
  2739.  * DDSCAPS_LOCALVIDMEM.
  2740.  */
  2741. #define DDSCAPS_NONLOCALVIDMEM                  0x20000000l
  2742.  
  2743. /*
  2744.  * Indicates that this surface is a standard VGA mode surface, and not a
  2745.  * ModeX surface. (This flag will never be set in combination with the
  2746.  * DDSCAPS_MODEX flag).
  2747.  */
  2748. #define DDSCAPS_STANDARDVGAMODE                 0x40000000l
  2749.  
  2750. /*
  2751.  * Indicates that this surface will be an optimized surface. This flag is
  2752.  * currently only valid in conjunction with the DDSCAPS_TEXTURE flag. The surface
  2753.  * will be created without any underlying video memory until loaded.
  2754.  */
  2755. #define DDSCAPS_OPTIMIZED                       0x80000000l
  2756.  
  2757.  
  2758.  
  2759. /*
  2760.  * This bit is reserved
  2761.  */
  2762. #define DDSCAPS2_RESERVED4                      0x00000002L
  2763. #define DDSCAPS2_HARDWAREDEINTERLACE            0x00000000L
  2764.  
  2765. /*
  2766.  * Indicates to the driver that this surface will be locked very frequently
  2767.  * (for procedural textures, dynamic lightmaps, etc). Surfaces with this cap
  2768.  * set must also have DDSCAPS_TEXTURE. This cap cannot be used with
  2769.  * DDSCAPS2_HINTSTATIC and DDSCAPS2_OPAQUE.
  2770.  */
  2771. #define DDSCAPS2_HINTDYNAMIC                    0x00000004L
  2772.  
  2773. /*
  2774.  * Indicates to the driver that this surface can be re-ordered/retiled on
  2775.  * load. This operation will not change the size of the texture. It is
  2776.  * relatively fast and symmetrical, since the application may lock these
  2777.  * bits (although it will take a performance hit when doing so). Surfaces
  2778.  * with this cap set must also have DDSCAPS_TEXTURE. This cap cannot be
  2779.  * used with DDSCAPS2_HINTDYNAMIC and DDSCAPS2_OPAQUE.
  2780.  */
  2781. #define DDSCAPS2_HINTSTATIC                     0x00000008L
  2782.  
  2783. /*
  2784.  * Indicates that the client would like this texture surface to be managed by the
  2785.  * DirectDraw/Direct3D runtime. Surfaces with this cap set must also have
  2786.  * DDSCAPS_TEXTURE set.
  2787.  */
  2788. #define DDSCAPS2_TEXTUREMANAGE                  0x00000010L
  2789.  
  2790. /*
  2791.  * These bits are reserved for internal use */
  2792. #define DDSCAPS2_RESERVED1                      0x00000020L
  2793. #define DDSCAPS2_RESERVED2                      0x00000040L
  2794.  
  2795. /*
  2796.  * Indicates to the driver that this surface will never be locked again.
  2797.  * The driver is free to optimize this surface via retiling and actual compression.
  2798.  * All calls to Lock() or Blts from this surface will fail. Surfaces with this
  2799.  * cap set must also have DDSCAPS_TEXTURE. This cap cannot be used with
  2800.  * DDSCAPS2_HINTDYNAMIC and DDSCAPS2_HINTSTATIC.
  2801.  */
  2802. #define DDSCAPS2_OPAQUE                         0x00000080L
  2803.  
  2804. /*
  2805.  * Applications should set this bit at CreateSurface time to indicate that they
  2806.  * intend to use antialiasing. Only valid if DDSCAPS_3DDEVICE is also set.
  2807.  */
  2808. #define DDSCAPS2_HINTANTIALIASING               0x00000100L
  2809.  
  2810.  
  2811. /*
  2812.  * This flag is used at CreateSurface time to indicate that this set of
  2813.  * surfaces is a cubic environment map
  2814.  */
  2815. #define DDSCAPS2_CUBEMAP                        0x00000200L
  2816.  
  2817. /*
  2818.  * These flags preform two functions:
  2819.  * - At CreateSurface time, they define which of the six cube faces are
  2820.  *   required by the application.
  2821.  * - After creation, each face in the cubemap will have exactly one of these
  2822.  *   bits set.
  2823.  */
  2824. #define DDSCAPS2_CUBEMAP_POSITIVEX              0x00000400L
  2825. #define DDSCAPS2_CUBEMAP_NEGATIVEX              0x00000800L
  2826. #define DDSCAPS2_CUBEMAP_POSITIVEY              0x00001000L
  2827. #define DDSCAPS2_CUBEMAP_NEGATIVEY              0x00002000L
  2828. #define DDSCAPS2_CUBEMAP_POSITIVEZ              0x00004000L
  2829. #define DDSCAPS2_CUBEMAP_NEGATIVEZ              0x00008000L
  2830.  
  2831. /*
  2832.  * This macro may be used to specify all faces of a cube map at CreateSurface time
  2833.  */
  2834. #define DDSCAPS2_CUBEMAP_ALLFACES ( DDSCAPS2_CUBEMAP_POSITIVEX |\
  2835.                                     DDSCAPS2_CUBEMAP_NEGATIVEX |\
  2836.                                     DDSCAPS2_CUBEMAP_POSITIVEY |\
  2837.                                     DDSCAPS2_CUBEMAP_NEGATIVEY |\
  2838.                                     DDSCAPS2_CUBEMAP_POSITIVEZ |\
  2839.                                     DDSCAPS2_CUBEMAP_NEGATIVEZ )
  2840.  
  2841.  
  2842. /*
  2843.  * This flag is an additional flag which is present on mipmap sublevels from DX7 onwards
  2844.  * It enables easier use of GetAttachedSurface rather than EnumAttachedSurfaces for surface
  2845.  * constructs such as Cube Maps, wherein there are more than one mipmap surface attached
  2846.  * to the root surface.
  2847.  * This caps bit is ignored by CreateSurface
  2848.  */
  2849. #define DDSCAPS2_MIPMAPSUBLEVEL                 0x00010000L
  2850.  
  2851. /* This flag indicates that the texture should be managed by D3D only */
  2852. #define DDSCAPS2_D3DTEXTUREMANAGE               0x00020000L
  2853.  
  2854. /* This flag indicates that the managed surface can be safely lost */
  2855. #define DDSCAPS2_DONOTPERSIST                   0x00040000L
  2856.  
  2857. /* indicates that this surface is part of a stereo flipping chain */
  2858. #define DDSCAPS2_STEREOSURFACELEFT              0x00080000L
  2859.  
  2860.  
  2861. /*
  2862.  * Indicates that the surface is a volume.
  2863.  * Can be combined with DDSCAPS_MIPMAP to indicate a multi-level volume
  2864.  */
  2865. #define DDSCAPS2_VOLUME                         0x00200000L
  2866.  
  2867. /*
  2868.  * Indicates that the surface may be locked multiple times by the application.
  2869.  * This cap cannot be used with DDSCAPS2_OPAQUE.
  2870.  */
  2871. #define DDSCAPS2_NOTUSERLOCKABLE                0x00400000L
  2872.  
  2873. /*
  2874.  * Indicates that the vertex buffer data can be used to render points and
  2875.  * point sprites.
  2876.  */
  2877. #define DDSCAPS2_POINTS                         0x00800000L
  2878.  
  2879. /*
  2880.  * Indicates that the vertex buffer data can be used to render rt pactches.
  2881.  */
  2882. #define DDSCAPS2_RTPATCHES                      0x01000000L
  2883.  
  2884. /*
  2885.  * Indicates that the vertex buffer data can be used to render n patches.
  2886.  */
  2887. #define DDSCAPS2_NPATCHES                       0x02000000L
  2888.  
  2889. /*
  2890.  * This bit is reserved for internal use 
  2891.  */
  2892. #define DDSCAPS2_RESERVED3                      0x04000000L
  2893.  
  2894.  
  2895. /*
  2896.  * Indicates that the contents of the backbuffer do not have to be preserved
  2897.  * the contents of the backbuffer after they are presented.
  2898.  */
  2899. #define DDSCAPS2_DISCARDBACKBUFFER              0x10000000L
  2900.  
  2901. /*
  2902.  * This is a mask that indicates the set of bits that may be set
  2903.  * at createsurface time to indicate number of samples per pixel
  2904.  * when multisampling
  2905.  */
  2906. #define DDSCAPS3_MULTISAMPLE_MASK               0x0000001FL
  2907.  
  2908.  
  2909.  /****************************************************************************
  2910.  *
  2911.  * DIRECTDRAW DRIVER CAPABILITY FLAGS
  2912.  *
  2913.  ****************************************************************************/
  2914.  
  2915. /*
  2916.  * Display hardware has 3D acceleration.
  2917.  */
  2918. #define DDCAPS_3D                       0x00000001l
  2919.  
  2920. /*
  2921.  * Indicates that DirectDraw will support only dest rectangles that are aligned
  2922.  * on DIRECTDRAWCAPS.dwAlignBoundaryDest boundaries of the surface, respectively.
  2923.  * READ ONLY.
  2924.  */
  2925. #define DDCAPS_ALIGNBOUNDARYDEST        0x00000002l
  2926.  
  2927. /*
  2928.  * Indicates that DirectDraw will support only source rectangles  whose sizes in
  2929.  * BYTEs are DIRECTDRAWCAPS.dwAlignSizeDest multiples, respectively.  READ ONLY.
  2930.  */
  2931. #define DDCAPS_ALIGNSIZEDEST            0x00000004l
  2932. /*
  2933.  * Indicates that DirectDraw will support only source rectangles that are aligned
  2934.  * on DIRECTDRAWCAPS.dwAlignBoundarySrc boundaries of the surface, respectively.
  2935.  * READ ONLY.
  2936.  */
  2937. #define DDCAPS_ALIGNBOUNDARYSRC         0x00000008l
  2938.  
  2939. /*
  2940.  * Indicates that DirectDraw will support only source rectangles  whose sizes in
  2941.  * BYTEs are DIRECTDRAWCAPS.dwAlignSizeSrc multiples, respectively.  READ ONLY.
  2942.  */
  2943. #define DDCAPS_ALIGNSIZESRC             0x00000010l
  2944.  
  2945. /*
  2946.  * Indicates that DirectDraw will create video memory surfaces that have a stride
  2947.  * alignment equal to DIRECTDRAWCAPS.dwAlignStride.  READ ONLY.
  2948.  */
  2949. #define DDCAPS_ALIGNSTRIDE              0x00000020l
  2950.  
  2951. /*
  2952.  * Display hardware is capable of blt operations.
  2953.  */
  2954. #define DDCAPS_BLT                      0x00000040l
  2955.  
  2956. /*
  2957.  * Display hardware is capable of asynchronous blt operations.
  2958.  */
  2959. #define DDCAPS_BLTQUEUE                 0x00000080l
  2960.  
  2961. /*
  2962.  * Display hardware is capable of color space conversions during the blt operation.
  2963.  */
  2964. #define DDCAPS_BLTFOURCC                0x00000100l
  2965.  
  2966. /*
  2967.  * Display hardware is capable of stretching during blt operations.
  2968.  */
  2969. #define DDCAPS_BLTSTRETCH               0x00000200l
  2970.  
  2971. /*
  2972.  * Display hardware is shared with GDI.
  2973.  */
  2974. #define DDCAPS_GDI                      0x00000400l
  2975.  
  2976. /*
  2977.  * Display hardware can overlay.
  2978.  */
  2979. #define DDCAPS_OVERLAY                  0x00000800l
  2980.  
  2981. /*
  2982.  * Set if display hardware supports overlays but can not clip them.
  2983.  */
  2984. #define DDCAPS_OVERLAYCANTCLIP          0x00001000l
  2985.  
  2986. /*
  2987.  * Indicates that overlay hardware is capable of color space conversions during
  2988.  * the overlay operation.
  2989.  */
  2990. #define DDCAPS_OVERLAYFOURCC            0x00002000l
  2991.  
  2992. /*
  2993.  * Indicates that stretching can be done by the overlay hardware.
  2994.  */
  2995. #define DDCAPS_OVERLAYSTRETCH           0x00004000l
  2996.  
  2997. /*
  2998.  * Indicates that unique DirectDrawPalettes can be created for DirectDrawSurfaces
  2999.  * other than the primary surface.
  3000.  */
  3001. #define DDCAPS_PALETTE                  0x00008000l
  3002.  
  3003. /*
  3004.  * Indicates that palette changes can be syncd with the veritcal refresh.
  3005.  */
  3006. #define DDCAPS_PALETTEVSYNC             0x00010000l
  3007.  
  3008. /*
  3009.  * Display hardware can return the current scan line.
  3010.  */
  3011. #define DDCAPS_READSCANLINE             0x00020000l
  3012.  
  3013.  
  3014. /*
  3015.  * This flag used to bo DDCAPS_STEREOVIEW, which is now obsolete
  3016.  */
  3017. #define DDCAPS_RESERVED1                0x00040000l
  3018.  
  3019. /*
  3020.  * Display hardware is capable of generating a vertical blank interrupt.
  3021.  */
  3022. #define DDCAPS_VBI                      0x00080000l
  3023.  
  3024. /*
  3025.  * Supports the use of z buffers with blt operations.
  3026.  */
  3027. #define DDCAPS_ZBLTS                    0x00100000l
  3028.  
  3029. /*
  3030.  * Supports Z Ordering of overlays.
  3031.  */
  3032. #define DDCAPS_ZOVERLAYS                0x00200000l
  3033.  
  3034. /*
  3035.  * Supports color key
  3036.  */
  3037. #define DDCAPS_COLORKEY                 0x00400000l
  3038.  
  3039. /*
  3040.  * Supports alpha surfaces
  3041.  */
  3042. #define DDCAPS_ALPHA                    0x00800000l
  3043.  
  3044. /*
  3045.  * colorkey is hardware assisted(DDCAPS_COLORKEY will also be set)
  3046.  */
  3047. #define DDCAPS_COLORKEYHWASSIST         0x01000000l
  3048.  
  3049. /*
  3050.  * no hardware support at all
  3051.  */
  3052. #define DDCAPS_NOHARDWARE               0x02000000l
  3053.  
  3054. /*
  3055.  * Display hardware is capable of color fill with bltter
  3056.  */
  3057. #define DDCAPS_BLTCOLORFILL             0x04000000l
  3058.  
  3059. /*
  3060.  * Display hardware is bank switched, and potentially very slow at
  3061.  * random access to VRAM.
  3062.  */
  3063. #define DDCAPS_BANKSWITCHED             0x08000000l
  3064.  
  3065. /*
  3066.  * Display hardware is capable of depth filling Z-buffers with bltter
  3067.  */
  3068. #define DDCAPS_BLTDEPTHFILL             0x10000000l
  3069.  
  3070. /*
  3071.  * Display hardware is capable of clipping while bltting.
  3072.  */
  3073. #define DDCAPS_CANCLIP                  0x20000000l
  3074.  
  3075. /*
  3076.  * Display hardware is capable of clipping while stretch bltting.
  3077.  */
  3078. #define DDCAPS_CANCLIPSTRETCHED         0x40000000l
  3079.  
  3080. /*
  3081.  * Display hardware is capable of bltting to or from system memory
  3082.  */
  3083. #define DDCAPS_CANBLTSYSMEM             0x80000000l
  3084.  
  3085.  
  3086.  /****************************************************************************
  3087.  *
  3088.  * MORE DIRECTDRAW DRIVER CAPABILITY FLAGS (dwCaps2)
  3089.  *
  3090.  ****************************************************************************/
  3091.  
  3092. /*
  3093.  * Display hardware is certified
  3094.  */
  3095. #define DDCAPS2_CERTIFIED              0x00000001l
  3096.  
  3097. /*
  3098.  * Driver cannot interleave 2D operations (lock and blt) to surfaces with
  3099.  * Direct3D rendering operations between calls to BeginScene() and EndScene()
  3100.  */
  3101. #define DDCAPS2_NO2DDURING3DSCENE       0x00000002l
  3102.  
  3103. /*
  3104.  * Display hardware contains a video port
  3105.  */
  3106. #define DDCAPS2_VIDEOPORT               0x00000004l
  3107.  
  3108. /*
  3109.  * The overlay can be automatically flipped according to the video port
  3110.  * VSYNCs, providing automatic doubled buffered display of video port
  3111.  * data using an overlay
  3112.  */
  3113. #define DDCAPS2_AUTOFLIPOVERLAY         0x00000008l
  3114.  
  3115. /*
  3116.  * Overlay can display each field of interlaced data individually while
  3117.  * it is interleaved in memory without causing jittery artifacts.
  3118.  */
  3119. #define DDCAPS2_CANBOBINTERLEAVED       0x00000010l
  3120.  
  3121. /*
  3122.  * Overlay can display each field of interlaced data individually while
  3123.  * it is not interleaved in memory without causing jittery artifacts.
  3124.  */
  3125. #define DDCAPS2_CANBOBNONINTERLEAVED    0x00000020l
  3126.  
  3127. /*
  3128.  * The overlay surface contains color controls (brightness, sharpness, etc.)
  3129.  */
  3130. #define DDCAPS2_COLORCONTROLOVERLAY     0x00000040l
  3131.  
  3132. /*
  3133.  * The primary surface contains color controls (gamma, etc.)
  3134.  */
  3135. #define DDCAPS2_COLORCONTROLPRIMARY     0x00000080l
  3136.  
  3137. /*
  3138.  * RGBZ -> RGB supported for 16:16 RGB:Z
  3139.  */
  3140. #define DDCAPS2_CANDROPZ16BIT           0x00000100l
  3141.  
  3142. /*
  3143.  * Driver supports non-local video memory.
  3144.  */
  3145. #define DDCAPS2_NONLOCALVIDMEM          0x00000200l
  3146.  
  3147. /*
  3148.  * Dirver supports non-local video memory but has different capabilities for
  3149.  * non-local video memory surfaces. If this bit is set then so must
  3150.  * DDCAPS2_NONLOCALVIDMEM.
  3151.  */
  3152. #define DDCAPS2_NONLOCALVIDMEMCAPS      0x00000400l
  3153.  
  3154. /*
  3155.  * Driver neither requires nor prefers surfaces to be pagelocked when performing
  3156.  * blts involving system memory surfaces
  3157.  */
  3158. #define DDCAPS2_NOPAGELOCKREQUIRED      0x00000800l
  3159.  
  3160. /*
  3161.  * Driver can create surfaces which are wider than the primary surface
  3162.  */
  3163. #define DDCAPS2_WIDESURFACES            0x00001000l
  3164.  
  3165. /*
  3166.  * Driver supports bob without using a video port by handling the
  3167.  * DDFLIP_ODD and DDFLIP_EVEN flags specified in Flip.
  3168.  */
  3169. #define DDCAPS2_CANFLIPODDEVEN          0x00002000l
  3170.  
  3171. /*
  3172.  * Driver supports bob using hardware
  3173.  */
  3174. #define DDCAPS2_CANBOBHARDWARE          0x00004000l
  3175.  
  3176. /*
  3177.  * Driver supports bltting any FOURCC surface to another surface of the same FOURCC
  3178.  */
  3179. #define DDCAPS2_COPYFOURCC              0x00008000l
  3180.  
  3181.  
  3182. /*
  3183.  * Driver supports loadable gamma ramps for the primary surface
  3184.  */
  3185. #define DDCAPS2_PRIMARYGAMMA            0x00020000l
  3186.  
  3187. /*
  3188.  * Driver can render in windowed mode.
  3189.  */
  3190. #define DDCAPS2_CANRENDERWINDOWED       0x00080000l
  3191.  
  3192. /*
  3193.  * A calibrator is available to adjust the gamma ramp according to the
  3194.  * physical display properties so that the result will be identical on
  3195.  * all calibrated systems.
  3196.  */
  3197. #define DDCAPS2_CANCALIBRATEGAMMA       0x00100000l
  3198.  
  3199. /*
  3200.  * Indicates that the driver will respond to DDFLIP_INTERVALn flags
  3201.  */
  3202. #define DDCAPS2_FLIPINTERVAL            0x00200000l
  3203.  
  3204. /*
  3205.  * Indicates that the driver will respond to DDFLIP_NOVSYNC
  3206.  */
  3207. #define DDCAPS2_FLIPNOVSYNC             0x00400000l
  3208.  
  3209. /*
  3210.  * Driver supports management of video memory, if this flag is ON,
  3211.  * driver manages the texture if requested with DDSCAPS2_TEXTUREMANAGE on
  3212.  * DirectX manages the texture if this flag is OFF and surface has DDSCAPS2_TEXTUREMANAGE on
  3213.  */
  3214. #define DDCAPS2_CANMANAGETEXTURE        0x00800000l
  3215.  
  3216. /*
  3217.  * The Direct3D texture manager uses this cap to decide whether to put managed
  3218.  * surfaces in non-local video memory. If the cap is set, the texture manager will
  3219.  * put managed surfaces in non-local vidmem. Drivers that cannot texture from
  3220.  * local vidmem SHOULD NOT set this cap.
  3221.  */
  3222. #define DDCAPS2_TEXMANINNONLOCALVIDMEM  0x01000000l
  3223.  
  3224. /*
  3225.  * Indicates that the driver supports DX7 type of stereo in at least one mode (which may
  3226.  * not necessarily be the current mode). Applications should use IDirectDraw7 (or higher)
  3227.  * ::EnumDisplayModes and check the DDSURFACEDESC.ddsCaps.dwCaps2 field for the presence of
  3228.  * DDSCAPS2_STEREOSURFACELEFT to check if a particular mode supports stereo. The application
  3229.  * can also use IDirectDraw7(or higher)::GetDisplayMode to check the current mode.
  3230.  */
  3231. #define DDCAPS2_STEREO                  0x02000000L
  3232.  
  3233. /*
  3234.  * This caps bit is intended for internal DirectDraw use.
  3235.  * -It is only valid if DDCAPS2_NONLOCALVIDMEMCAPS is set.
  3236.  * -If this bit is set, then DDCAPS_CANBLTSYSMEM MUST be set by the driver (and
  3237.  *  all the assoicated system memory blt caps must be correct).
  3238.  * -It implies that the system->video blt caps in DDCAPS also apply to system to
  3239.  *  nonlocal blts. I.e. the dwSVBCaps, dwSVBCKeyCaps, dwSVBFXCaps and dwSVBRops
  3240.  *  members of DDCAPS (DDCORECAPS) are filled in correctly.
  3241.  * -Any blt from system to nonlocal memory that matches these caps bits will
  3242.  *  be passed to the driver.
  3243.  *
  3244.  * NOTE: This is intended to enable the driver itself to do efficient reordering
  3245.  * of textures. This is NOT meant to imply that hardware can write into AGP memory.
  3246.  * This operation is not currently supported.
  3247.  */
  3248. #define DDCAPS2_SYSTONONLOCAL_AS_SYSTOLOCAL   0x04000000L
  3249.  
  3250. /*
  3251.  * Indicates that the driver can support PUREHAL.
  3252.  */
  3253. #define DDCAPS2_PUREHAL                       0x08000000L
  3254.  
  3255.  
  3256. /****************************************************************************
  3257.  *
  3258.  * DIRECTDRAW FX ALPHA CAPABILITY FLAGS
  3259.  *
  3260.  ****************************************************************************/
  3261.  
  3262. /*
  3263.  * Supports alpha blending around the edge of a source color keyed surface.
  3264.  * For Blt.
  3265.  */
  3266. #define DDFXALPHACAPS_BLTALPHAEDGEBLEND         0x00000001l
  3267.  
  3268. /*
  3269.  * Supports alpha information in the pixel format.  The bit depth of alpha
  3270.  * information in the pixel format can be 1,2,4, or 8.  The alpha value becomes
  3271.  * more opaque as the alpha value increases.  (0 is transparent.)
  3272.  * For Blt.
  3273.  */
  3274. #define DDFXALPHACAPS_BLTALPHAPIXELS            0x00000002l
  3275.  
  3276. /*
  3277.  * Supports alpha information in the pixel format.  The bit depth of alpha
  3278.  * information in the pixel format can be 1,2,4, or 8.  The alpha value
  3279.  * becomes more transparent as the alpha value increases.  (0 is opaque.)
  3280.  * This flag can only be set if DDCAPS_ALPHA is set.
  3281.  * For Blt.
  3282.  */
  3283. #define DDFXALPHACAPS_BLTALPHAPIXELSNEG         0x00000004l
  3284.  
  3285. /*
  3286.  * Supports alpha only surfaces.  The bit depth of an alpha only surface can be
  3287.  * 1,2,4, or 8.  The alpha value becomes more opaque as the alpha value increases.
  3288.  * (0 is transparent.)
  3289.  * For Blt.
  3290.  */
  3291. #define DDFXALPHACAPS_BLTALPHASURFACES          0x00000008l
  3292.  
  3293. /*
  3294.  * The depth of the alpha channel data can range can be 1,2,4, or 8.
  3295.  * The NEG suffix indicates that this alpha channel becomes more transparent
  3296.  * as the alpha value increases. (0 is opaque.)  This flag can only be set if
  3297.  * DDCAPS_ALPHA is set.
  3298.  * For Blt.
  3299.  */
  3300. #define DDFXALPHACAPS_BLTALPHASURFACESNEG       0x00000010l
  3301.  
  3302. /*
  3303.  * Supports alpha blending around the edge of a source color keyed surface.
  3304.  * For Overlays.
  3305.  */
  3306. #define DDFXALPHACAPS_OVERLAYALPHAEDGEBLEND     0x00000020l
  3307.  
  3308. /*
  3309.  * Supports alpha information in the pixel format.  The bit depth of alpha
  3310.  * information in the pixel format can be 1,2,4, or 8.  The alpha value becomes
  3311.  * more opaque as the alpha value increases.  (0 is transparent.)
  3312.  * For Overlays.
  3313.  */
  3314. #define DDFXALPHACAPS_OVERLAYALPHAPIXELS        0x00000040l
  3315.  
  3316. /*
  3317.  * Supports alpha information in the pixel format.  The bit depth of alpha
  3318.  * information in the pixel format can be 1,2,4, or 8.  The alpha value
  3319.  * becomes more transparent as the alpha value increases.  (0 is opaque.)
  3320.  * This flag can only be set if DDCAPS_ALPHA is set.
  3321.  * For Overlays.
  3322.  */
  3323. #define DDFXALPHACAPS_OVERLAYALPHAPIXELSNEG     0x00000080l
  3324.  
  3325. /*
  3326.  * Supports alpha only surfaces.  The bit depth of an alpha only surface can be
  3327.  * 1,2,4, or 8.  The alpha value becomes more opaque as the alpha value increases.
  3328.  * (0 is transparent.)
  3329.  * For Overlays.
  3330.  */
  3331. #define DDFXALPHACAPS_OVERLAYALPHASURFACES      0x00000100l
  3332.  
  3333. /*
  3334.  * The depth of the alpha channel data can range can be 1,2,4, or 8.
  3335.  * The NEG suffix indicates that this alpha channel becomes more transparent
  3336.  * as the alpha value increases. (0 is opaque.)  This flag can only be set if
  3337.  * DDCAPS_ALPHA is set.
  3338.  * For Overlays.
  3339.  */
  3340. #define DDFXALPHACAPS_OVERLAYALPHASURFACESNEG   0x00000200l
  3341.  
  3342. #if DIRECTDRAW_VERSION < 0x0600
  3343. #endif  //DIRECTDRAW_VERSION
  3344.  
  3345.  
  3346. /****************************************************************************
  3347.  *
  3348.  * DIRECTDRAW FX CAPABILITY FLAGS
  3349.  *
  3350.  ****************************************************************************/
  3351.  
  3352. /*
  3353.  * Uses arithmetic operations to stretch and shrink surfaces during blt
  3354.  * rather than pixel doubling techniques.  Along the Y axis.
  3355.  */
  3356. #define DDFXCAPS_BLTARITHSTRETCHY       0x00000020l
  3357.  
  3358. /*
  3359.  * Uses arithmetic operations to stretch during blt
  3360.  * rather than pixel doubling techniques.  Along the Y axis. Only
  3361.  * works for x1, x2, etc.
  3362.  */
  3363. #define DDFXCAPS_BLTARITHSTRETCHYN      0x00000010l
  3364.  
  3365. /*
  3366.  * Supports mirroring left to right in blt.
  3367.  */
  3368. #define DDFXCAPS_BLTMIRRORLEFTRIGHT     0x00000040l
  3369.  
  3370. /*
  3371.  * Supports mirroring top to bottom in blt.
  3372.  */
  3373. #define DDFXCAPS_BLTMIRRORUPDOWN        0x00000080l
  3374.  
  3375. /*
  3376.  * Supports arbitrary rotation for blts.
  3377.  */
  3378. #define DDFXCAPS_BLTROTATION            0x00000100l
  3379.  
  3380. /*
  3381.  * Supports 90 degree rotations for blts.
  3382.  */
  3383. #define DDFXCAPS_BLTROTATION90          0x00000200l
  3384.  
  3385. /*
  3386.  * DirectDraw supports arbitrary shrinking of a surface along the
  3387.  * x axis (horizontal direction) for blts.
  3388.  */
  3389. #define DDFXCAPS_BLTSHRINKX             0x00000400l
  3390.  
  3391. /*
  3392.  * DirectDraw supports integer shrinking (1x,2x,) of a surface
  3393.  * along the x axis (horizontal direction) for blts.
  3394.  */
  3395. #define DDFXCAPS_BLTSHRINKXN            0x00000800l
  3396.  
  3397. /*
  3398.  * DirectDraw supports arbitrary shrinking of a surface along the
  3399.  * y axis (horizontal direction) for blts.
  3400.  */
  3401. #define DDFXCAPS_BLTSHRINKY             0x00001000l
  3402.  
  3403. /*
  3404.  * DirectDraw supports integer shrinking (1x,2x,) of a surface
  3405.  * along the y axis (vertical direction) for blts.
  3406.  */
  3407. #define DDFXCAPS_BLTSHRINKYN            0x00002000l
  3408.  
  3409. /*
  3410.  * DirectDraw supports arbitrary stretching of a surface along the
  3411.  * x axis (horizontal direction) for blts.
  3412.  */
  3413. #define DDFXCAPS_BLTSTRETCHX            0x00004000l
  3414.  
  3415. /*
  3416.  * DirectDraw supports integer stretching (1x,2x,) of a surface
  3417.  * along the x axis (horizontal direction) for blts.
  3418.  */
  3419. #define DDFXCAPS_BLTSTRETCHXN           0x00008000l
  3420.  
  3421. /*
  3422.  * DirectDraw supports arbitrary stretching of a surface along the
  3423.  * y axis (horizontal direction) for blts.
  3424.  */
  3425. #define DDFXCAPS_BLTSTRETCHY            0x00010000l
  3426.  
  3427. /*
  3428.  * DirectDraw supports integer stretching (1x,2x,) of a surface
  3429.  * along the y axis (vertical direction) for blts.
  3430.  */
  3431. #define DDFXCAPS_BLTSTRETCHYN           0x00020000l
  3432.  
  3433. /*
  3434.  * Uses arithmetic operations to stretch and shrink surfaces during
  3435.  * overlay rather than pixel doubling techniques.  Along the Y axis
  3436.  * for overlays.
  3437.  */
  3438. #define DDFXCAPS_OVERLAYARITHSTRETCHY   0x00040000l
  3439.  
  3440. /*
  3441.  * Uses arithmetic operations to stretch surfaces during
  3442.  * overlay rather than pixel doubling techniques.  Along the Y axis
  3443.  * for overlays. Only works for x1, x2, etc.
  3444.  */
  3445. #define DDFXCAPS_OVERLAYARITHSTRETCHYN  0x00000008l
  3446.  
  3447. /*
  3448.  * DirectDraw supports arbitrary shrinking of a surface along the
  3449.  * x axis (horizontal direction) for overlays.
  3450.  */
  3451. #define DDFXCAPS_OVERLAYSHRINKX         0x00080000l
  3452.  
  3453. /*
  3454.  * DirectDraw supports integer shrinking (1x,2x,) of a surface
  3455.  * along the x axis (horizontal direction) for overlays.
  3456.  */
  3457. #define DDFXCAPS_OVERLAYSHRINKXN        0x00100000l
  3458.  
  3459. /*
  3460.  * DirectDraw supports arbitrary shrinking of a surface along the
  3461.  * y axis (horizontal direction) for overlays.
  3462.  */
  3463. #define DDFXCAPS_OVERLAYSHRINKY         0x00200000l
  3464.  
  3465. /*
  3466.  * DirectDraw supports integer shrinking (1x,2x,) of a surface
  3467.  * along the y axis (vertical direction) for overlays.
  3468.  */
  3469. #define DDFXCAPS_OVERLAYSHRINKYN        0x00400000l
  3470.  
  3471. /*
  3472.  * DirectDraw supports arbitrary stretching of a surface along the
  3473.  * x axis (horizontal direction) for overlays.
  3474.  */
  3475. #define DDFXCAPS_OVERLAYSTRETCHX        0x00800000l
  3476.  
  3477. /*
  3478.  * DirectDraw supports integer stretching (1x,2x,) of a surface
  3479.  * along the x axis (horizontal direction) for overlays.
  3480.  */
  3481. #define DDFXCAPS_OVERLAYSTRETCHXN       0x01000000l
  3482.  
  3483. /*
  3484.  * DirectDraw supports arbitrary stretching of a surface along the
  3485.  * y axis (horizontal direction) for overlays.
  3486.  */
  3487. #define DDFXCAPS_OVERLAYSTRETCHY        0x02000000l
  3488.  
  3489. /*
  3490.  * DirectDraw supports integer stretching (1x,2x,) of a surface
  3491.  * along the y axis (vertical direction) for overlays.
  3492.  */
  3493. #define DDFXCAPS_OVERLAYSTRETCHYN       0x04000000l
  3494.  
  3495. /*
  3496.  * DirectDraw supports mirroring of overlays across the vertical axis
  3497.  */
  3498. #define DDFXCAPS_OVERLAYMIRRORLEFTRIGHT 0x08000000l
  3499.  
  3500. /*
  3501.  * DirectDraw supports mirroring of overlays across the horizontal axis
  3502.  */
  3503. #define DDFXCAPS_OVERLAYMIRRORUPDOWN    0x10000000l
  3504.  
  3505. /*
  3506.  * DirectDraw supports deinterlacing of overlay surfaces
  3507.  */
  3508. #define DDFXCAPS_OVERLAYDEINTERLACE        0x20000000l
  3509.  
  3510. /*
  3511.  * Driver can do alpha blending for blits.
  3512.  */
  3513. #define DDFXCAPS_BLTALPHA               0x00000001l
  3514.  
  3515.  
  3516. /*
  3517.  * Driver can do surface-reconstruction filtering for warped blits.
  3518.  */
  3519. #define DDFXCAPS_BLTFILTER              DDFXCAPS_BLTARITHSTRETCHY
  3520.  
  3521. /*
  3522.  * Driver can do alpha blending for overlays.
  3523.  */
  3524. #define DDFXCAPS_OVERLAYALPHA           0x00000004l
  3525.  
  3526.  
  3527. /*
  3528.  * Driver can do surface-reconstruction filtering for warped overlays.
  3529.  */
  3530. #define DDFXCAPS_OVERLAYFILTER          DDFXCAPS_OVERLAYARITHSTRETCHY
  3531.  
  3532. /****************************************************************************
  3533.  *
  3534.  * DIRECTDRAW STEREO VIEW CAPABILITIES
  3535.  *
  3536.  ****************************************************************************/
  3537.  
  3538. /*
  3539.  * This flag used to be DDSVCAPS_ENIGMA, which is now obsolete
  3540.  */
  3541.  
  3542. #define DDSVCAPS_RESERVED1              0x00000001l
  3543.  
  3544. /*
  3545.  * This flag used to be DDSVCAPS_FLICKER, which is now obsolete
  3546.  */
  3547. #define DDSVCAPS_RESERVED2              0x00000002l
  3548.  
  3549. /*
  3550.  * This flag used to be DDSVCAPS_REDBLUE, which is now obsolete
  3551.  */
  3552. #define DDSVCAPS_RESERVED3              0x00000004l
  3553.  
  3554. /*
  3555.  * This flag used to be DDSVCAPS_SPLIT, which is now obsolete
  3556.  */
  3557. #define DDSVCAPS_RESERVED4              0x00000008l
  3558.  
  3559. /*
  3560.  * The stereo view is accomplished with switching technology
  3561.  */
  3562.  
  3563. #define DDSVCAPS_STEREOSEQUENTIAL       0x00000010L
  3564.  
  3565.  
  3566.  
  3567.  
  3568. /****************************************************************************
  3569.  *
  3570.  * DIRECTDRAWPALETTE CAPABILITIES
  3571.  *
  3572.  ****************************************************************************/
  3573.  
  3574. /*
  3575.  * Index is 4 bits.  There are sixteen color entries in the palette table.
  3576.  */
  3577. #define DDPCAPS_4BIT                    0x00000001l
  3578.  
  3579. /*
  3580.  * Index is onto a 8 bit color index.  This field is only valid with the
  3581.  * DDPCAPS_1BIT, DDPCAPS_2BIT or DDPCAPS_4BIT capability and the target
  3582.  * surface is in 8bpp. Each color entry is one byte long and is an index
  3583.  * into destination surface's 8bpp palette.
  3584.  */
  3585. #define DDPCAPS_8BITENTRIES             0x00000002l
  3586.  
  3587. /*
  3588.  * Index is 8 bits.  There are 256 color entries in the palette table.
  3589.  */
  3590. #define DDPCAPS_8BIT                    0x00000004l
  3591.  
  3592. /*
  3593.  * Indicates that this DIRECTDRAWPALETTE should use the palette color array
  3594.  * passed into the lpDDColorArray parameter to initialize the DIRECTDRAWPALETTE
  3595.  * object.
  3596.  * This flag is obsolete. DirectDraw always initializes the color array from
  3597.  * the lpDDColorArray parameter. The definition remains for source-level
  3598.  * compatibility.
  3599.  */
  3600. #define DDPCAPS_INITIALIZE              0x00000000l
  3601.  
  3602. /*
  3603.  * This palette is the one attached to the primary surface.  Changing this
  3604.  * table has immediate effect on the display unless DDPSETPAL_VSYNC is specified
  3605.  * and supported.
  3606.  */
  3607. #define DDPCAPS_PRIMARYSURFACE          0x00000010l
  3608.  
  3609. /*
  3610.  * This palette is the one attached to the primary surface left.  Changing
  3611.  * this table has immediate effect on the display for the left eye unless
  3612.  * DDPSETPAL_VSYNC is specified and supported.
  3613.  */
  3614. #define DDPCAPS_PRIMARYSURFACELEFT      0x00000020l
  3615.  
  3616. /*
  3617.  * This palette can have all 256 entries defined
  3618.  */
  3619. #define DDPCAPS_ALLOW256                0x00000040l
  3620.  
  3621. /*
  3622.  * This palette can have modifications to it synced with the monitors
  3623.  * refresh rate.
  3624.  */
  3625. #define DDPCAPS_VSYNC                   0x00000080l
  3626.  
  3627. /*
  3628.  * Index is 1 bit.  There are two color entries in the palette table.
  3629.  */
  3630. #define DDPCAPS_1BIT                    0x00000100l
  3631.  
  3632. /*
  3633.  * Index is 2 bit.  There are four color entries in the palette table.
  3634.  */
  3635. #define DDPCAPS_2BIT                    0x00000200l
  3636.  
  3637. /*
  3638.  * The peFlags member of PALETTEENTRY denotes an 8 bit alpha value
  3639.  */
  3640. #define DDPCAPS_ALPHA                   0x00000400l
  3641.  
  3642.  
  3643. /****************************************************************************
  3644.  *
  3645.  * DIRECTDRAWPALETTE SETENTRY CONSTANTS
  3646.  *
  3647.  ****************************************************************************/
  3648.  
  3649.  
  3650. /****************************************************************************
  3651.  *
  3652.  * DIRECTDRAWPALETTE GETENTRY CONSTANTS
  3653.  *
  3654.  ****************************************************************************/
  3655.  
  3656. /* 0 is the only legal value */
  3657.  
  3658. /****************************************************************************
  3659.  *
  3660.  * DIRECTDRAWSURFACE SETPRIVATEDATA CONSTANTS
  3661.  *
  3662.  ****************************************************************************/
  3663.  
  3664. /*
  3665.  * The passed pointer is an IUnknown ptr. The cbData argument to SetPrivateData
  3666.  * must be set to sizeof(IUnknown*). DirectDraw will call AddRef through this
  3667.  * pointer and Release when the private data is destroyed. This includes when
  3668.  * the surface or palette is destroyed before such priovate data is destroyed.
  3669.  */
  3670. #define DDSPD_IUNKNOWNPOINTER           0x00000001L
  3671.  
  3672. /*
  3673.  * Private data is only valid for the current state of the object,
  3674.  * as determined by the uniqueness value.
  3675.  */
  3676. #define DDSPD_VOLATILE                  0x00000002L
  3677.  
  3678.  
  3679. /****************************************************************************
  3680.  *
  3681.  * DIRECTDRAWSURFACE SETPALETTE CONSTANTS
  3682.  *
  3683.  ****************************************************************************/
  3684.  
  3685.  
  3686. /****************************************************************************
  3687.  *
  3688.  * DIRECTDRAW BITDEPTH CONSTANTS
  3689.  *
  3690.  * NOTE:  These are only used to indicate supported bit depths.   These
  3691.  * are flags only, they are not to be used as an actual bit depth.   The
  3692.  * absolute numbers 1, 2, 4, 8, 16, 24 and 32 are used to indicate actual
  3693.  * bit depths in a surface or for changing the display mode.
  3694.  *
  3695.  ****************************************************************************/
  3696.  
  3697. /*
  3698.  * 1 bit per pixel.
  3699.  */
  3700. #define DDBD_1                  0x00004000l
  3701.  
  3702. /*
  3703.  * 2 bits per pixel.
  3704.  */
  3705. #define DDBD_2                  0x00002000l
  3706.  
  3707. /*
  3708.  * 4 bits per pixel.
  3709.  */
  3710. #define DDBD_4                  0x00001000l
  3711.  
  3712. /*
  3713.  * 8 bits per pixel.
  3714.  */
  3715. #define DDBD_8                  0x00000800l
  3716.  
  3717. /*
  3718.  * 16 bits per pixel.
  3719.  */
  3720. #define DDBD_16                 0x00000400l
  3721.  
  3722. /*
  3723.  * 24 bits per pixel.
  3724.  */
  3725. #define DDBD_24                 0X00000200l
  3726.  
  3727. /*
  3728.  * 32 bits per pixel.
  3729.  */
  3730. #define DDBD_32                 0x00000100l
  3731.  
  3732. /****************************************************************************
  3733.  *
  3734.  * DIRECTDRAWSURFACE SET/GET COLOR KEY FLAGS
  3735.  *
  3736.  ****************************************************************************/
  3737.  
  3738. /*
  3739.  * Set if the structure contains a color space.  Not set if the structure
  3740.  * contains a single color key.
  3741.  */
  3742. #define DDCKEY_COLORSPACE       0x00000001l
  3743.  
  3744. /*
  3745.  * Set if the structure specifies a color key or color space which is to be
  3746.  * used as a destination color key for blt operations.
  3747.  */
  3748. #define DDCKEY_DESTBLT          0x00000002l
  3749.  
  3750. /*
  3751.  * Set if the structure specifies a color key or color space which is to be
  3752.  * used as a destination color key for overlay operations.
  3753.  */
  3754. #define DDCKEY_DESTOVERLAY      0x00000004l
  3755.  
  3756. /*
  3757.  * Set if the structure specifies a color key or color space which is to be
  3758.  * used as a source color key for blt operations.
  3759.  */
  3760. #define DDCKEY_SRCBLT           0x00000008l
  3761.  
  3762. /*
  3763.  * Set if the structure specifies a color key or color space which is to be
  3764.  * used as a source color key for overlay operations.
  3765.  */
  3766. #define DDCKEY_SRCOVERLAY       0x00000010l
  3767.  
  3768.  
  3769. /****************************************************************************
  3770.  *
  3771.  * DIRECTDRAW COLOR KEY CAPABILITY FLAGS
  3772.  *
  3773.  ****************************************************************************/
  3774.  
  3775. /*
  3776.  * Supports transparent blting using a color key to identify the replaceable
  3777.  * bits of the destination surface for RGB colors.
  3778.  */
  3779. #define DDCKEYCAPS_DESTBLT                      0x00000001l
  3780.  
  3781. /*
  3782.  * Supports transparent blting using a color space to identify the replaceable
  3783.  * bits of the destination surface for RGB colors.
  3784.  */
  3785. #define DDCKEYCAPS_DESTBLTCLRSPACE              0x00000002l
  3786.  
  3787. /*
  3788.  * Supports transparent blting using a color space to identify the replaceable
  3789.  * bits of the destination surface for YUV colors.
  3790.  */
  3791. #define DDCKEYCAPS_DESTBLTCLRSPACEYUV           0x00000004l
  3792.  
  3793. /*
  3794.  * Supports transparent blting using a color key to identify the replaceable
  3795.  * bits of the destination surface for YUV colors.
  3796.  */
  3797. #define DDCKEYCAPS_DESTBLTYUV                   0x00000008l
  3798.  
  3799. /*
  3800.  * Supports overlaying using colorkeying of the replaceable bits of the surface
  3801.  * being overlayed for RGB colors.
  3802.  */
  3803. #define DDCKEYCAPS_DESTOVERLAY                  0x00000010l
  3804.  
  3805. /*
  3806.  * Supports a color space as the color key for the destination for RGB colors.
  3807.  */
  3808. #define DDCKEYCAPS_DESTOVERLAYCLRSPACE          0x00000020l
  3809.  
  3810. /*
  3811.  * Supports a color space as the color key for the destination for YUV colors.
  3812.  */
  3813. #define DDCKEYCAPS_DESTOVERLAYCLRSPACEYUV       0x00000040l
  3814.  
  3815. /*
  3816.  * Supports only one active destination color key value for visible overlay
  3817.  * surfaces.
  3818.  */
  3819. #define DDCKEYCAPS_DESTOVERLAYONEACTIVE         0x00000080l
  3820.  
  3821. /*
  3822.  * Supports overlaying using colorkeying of the replaceable bits of the
  3823.  * surface being overlayed for YUV colors.
  3824.  */
  3825. #define DDCKEYCAPS_DESTOVERLAYYUV               0x00000100l
  3826.  
  3827. /*
  3828.  * Supports transparent blting using the color key for the source with
  3829.  * this surface for RGB colors.
  3830.  */
  3831. #define DDCKEYCAPS_SRCBLT                       0x00000200l
  3832.  
  3833. /*
  3834.  * Supports transparent blting using a color space for the source with
  3835.  * this surface for RGB colors.
  3836.  */
  3837. #define DDCKEYCAPS_SRCBLTCLRSPACE               0x00000400l
  3838.  
  3839. /*
  3840.  * Supports transparent blting using a color space for the source with
  3841.  * this surface for YUV colors.
  3842.  */
  3843. #define DDCKEYCAPS_SRCBLTCLRSPACEYUV            0x00000800l
  3844.  
  3845. /*
  3846.  * Supports transparent blting using the color key for the source with
  3847.  * this surface for YUV colors.
  3848.  */
  3849. #define DDCKEYCAPS_SRCBLTYUV                    0x00001000l
  3850.  
  3851. /*
  3852.  * Supports overlays using the color key for the source with this
  3853.  * overlay surface for RGB colors.
  3854.  */
  3855. #define DDCKEYCAPS_SRCOVERLAY                   0x00002000l
  3856.  
  3857. /*
  3858.  * Supports overlays using a color space as the source color key for
  3859.  * the overlay surface for RGB colors.
  3860.  */
  3861. #define DDCKEYCAPS_SRCOVERLAYCLRSPACE           0x00004000l
  3862.  
  3863. /*
  3864.  * Supports overlays using a color space as the source color key for
  3865.  * the overlay surface for YUV colors.
  3866.  */
  3867. #define DDCKEYCAPS_SRCOVERLAYCLRSPACEYUV        0x00008000l
  3868.  
  3869. /*
  3870.  * Supports only one active source color key value for visible
  3871.  * overlay surfaces.
  3872.  */
  3873. #define DDCKEYCAPS_SRCOVERLAYONEACTIVE          0x00010000l
  3874.  
  3875. /*
  3876.  * Supports overlays using the color key for the source with this
  3877.  * overlay surface for YUV colors.
  3878.  */
  3879. #define DDCKEYCAPS_SRCOVERLAYYUV                0x00020000l
  3880.  
  3881. /*
  3882.  * there are no bandwidth trade-offs for using colorkey with an overlay
  3883.  */
  3884. #define DDCKEYCAPS_NOCOSTOVERLAY                0x00040000l
  3885.  
  3886.  
  3887. /****************************************************************************
  3888.  *
  3889.  * DIRECTDRAW PIXELFORMAT FLAGS
  3890.  *
  3891.  ****************************************************************************/
  3892.  
  3893. /*
  3894.  * The surface has alpha channel information in the pixel format.
  3895.  */
  3896. #define DDPF_ALPHAPIXELS                        0x00000001l
  3897.  
  3898. /*
  3899.  * The pixel format contains alpha only information
  3900.  */
  3901. #define DDPF_ALPHA                              0x00000002l
  3902.  
  3903. /*
  3904.  * The FourCC code is valid.
  3905.  */
  3906. #define DDPF_FOURCC                             0x00000004l
  3907.  
  3908. /*
  3909.  * The surface is 4-bit color indexed.
  3910.  */
  3911. #define DDPF_PALETTEINDEXED4                    0x00000008l
  3912.  
  3913. /*
  3914.  * The surface is indexed into a palette which stores indices
  3915.  * into the destination surface's 8-bit palette.
  3916.  */
  3917. #define DDPF_PALETTEINDEXEDTO8                  0x00000010l
  3918.  
  3919. /*
  3920.  * The surface is 8-bit color indexed.
  3921.  */
  3922. #define DDPF_PALETTEINDEXED8                    0x00000020l
  3923.  
  3924. /*
  3925.  * The RGB data in the pixel format structure is valid.
  3926.  */
  3927. #define DDPF_RGB                                0x00000040l
  3928.  
  3929. /*
  3930.  * The surface will accept pixel data in the format specified
  3931.  * and compress it during the write.
  3932.  */
  3933. #define DDPF_COMPRESSED                         0x00000080l
  3934.  
  3935. /*
  3936.  * The surface will accept RGB data and translate it during
  3937.  * the write to YUV data.  The format of the data to be written
  3938.  * will be contained in the pixel format structure.  The DDPF_RGB
  3939.  * flag will be set.
  3940.  */
  3941. #define DDPF_RGBTOYUV                           0x00000100l
  3942.  
  3943. /*
  3944.  * pixel format is YUV - YUV data in pixel format struct is valid
  3945.  */
  3946. #define DDPF_YUV                                0x00000200l
  3947.  
  3948. /*
  3949.  * pixel format is a z buffer only surface
  3950.  */
  3951. #define DDPF_ZBUFFER                            0x00000400l
  3952.  
  3953. /*
  3954.  * The surface is 1-bit color indexed.
  3955.  */
  3956. #define DDPF_PALETTEINDEXED1                    0x00000800l
  3957.  
  3958. /*
  3959.  * The surface is 2-bit color indexed.
  3960.  */
  3961. #define DDPF_PALETTEINDEXED2                    0x00001000l
  3962.  
  3963. /*
  3964.  * The surface contains Z information in the pixels
  3965.  */
  3966. #define DDPF_ZPIXELS                            0x00002000l
  3967.  
  3968. /*
  3969.  * The surface contains stencil information along with Z
  3970.  */
  3971. #define DDPF_STENCILBUFFER                      0x00004000l
  3972.  
  3973. /*
  3974.  * Premultiplied alpha format -- the color components have been
  3975.  * premultiplied by the alpha component.
  3976.  */
  3977. #define DDPF_ALPHAPREMULT                       0x00008000l
  3978.  
  3979.  
  3980. /*
  3981.  * Luminance data in the pixel format is valid.
  3982.  * Use this flag for luminance-only or luminance+alpha surfaces,
  3983.  * the bit depth is then ddpf.dwLuminanceBitCount.
  3984.  */
  3985. #define DDPF_LUMINANCE                          0x00020000l
  3986.  
  3987. /*
  3988.  * Luminance data in the pixel format is valid.
  3989.  * Use this flag when hanging luminance off bumpmap surfaces,
  3990.  * the bit mask for the luminance portion of the pixel is then
  3991.  * ddpf.dwBumpLuminanceBitMask
  3992.  */
  3993. #define DDPF_BUMPLUMINANCE                      0x00040000l
  3994.  
  3995. /*
  3996.  * Bump map dUdV data in the pixel format is valid.
  3997.  */
  3998. #define DDPF_BUMPDUDV                           0x00080000l
  3999.  
  4000.  
  4001. /*===========================================================================
  4002.  *
  4003.  *
  4004.  * DIRECTDRAW CALLBACK FLAGS
  4005.  *
  4006.  *
  4007.  *==========================================================================*/
  4008.  
  4009. /****************************************************************************
  4010.  *
  4011.  * DIRECTDRAW ENUMSURFACES FLAGS
  4012.  *
  4013.  ****************************************************************************/
  4014.  
  4015. /*
  4016.  * Enumerate all of the surfaces that meet the search criterion.
  4017.  */
  4018. #define DDENUMSURFACES_ALL                      0x00000001l
  4019.  
  4020. /*
  4021.  * A search hit is a surface that matches the surface description.
  4022.  */
  4023. #define DDENUMSURFACES_MATCH                    0x00000002l
  4024.  
  4025. /*
  4026.  * A search hit is a surface that does not match the surface description.
  4027.  */
  4028. #define DDENUMSURFACES_NOMATCH                  0x00000004l
  4029.  
  4030. /*
  4031.  * Enumerate the first surface that can be created which meets the search criterion.
  4032.  */
  4033. #define DDENUMSURFACES_CANBECREATED             0x00000008l
  4034.  
  4035. /*
  4036.  * Enumerate the surfaces that already exist that meet the search criterion.
  4037.  */
  4038. #define DDENUMSURFACES_DOESEXIST                0x00000010l
  4039.  
  4040.  
  4041. /****************************************************************************
  4042.  *
  4043.  * DIRECTDRAW SETDISPLAYMODE FLAGS
  4044.  *
  4045.  ****************************************************************************/
  4046.  
  4047. /*
  4048.  * The desired mode is a standard VGA mode
  4049.  */
  4050. #define DDSDM_STANDARDVGAMODE                   0x00000001l
  4051.  
  4052.  
  4053. /****************************************************************************
  4054.  *
  4055.  * DIRECTDRAW ENUMDISPLAYMODES FLAGS
  4056.  *
  4057.  ****************************************************************************/
  4058.  
  4059. /*
  4060.  * Enumerate Modes with different refresh rates.  EnumDisplayModes guarantees
  4061.  * that a particular mode will be enumerated only once.  This flag specifies whether
  4062.  * the refresh rate is taken into account when determining if a mode is unique.
  4063.  */
  4064. #define DDEDM_REFRESHRATES                      0x00000001l
  4065.  
  4066. /*
  4067.  * Enumerate VGA modes. Specify this flag if you wish to enumerate supported VGA
  4068.  * modes such as mode 0x13 in addition to the usual ModeX modes (which are always
  4069.  * enumerated if the application has previously called SetCooperativeLevel with the
  4070.  * DDSCL_ALLOWMODEX flag set).
  4071.  */
  4072. #define DDEDM_STANDARDVGAMODES                  0x00000002L
  4073.  
  4074.  
  4075. /****************************************************************************
  4076.  *
  4077.  * DIRECTDRAW SETCOOPERATIVELEVEL FLAGS
  4078.  *
  4079.  ****************************************************************************/
  4080.  
  4081. /*
  4082.  * Exclusive mode owner will be responsible for the entire primary surface.
  4083.  * GDI can be ignored. used with DD
  4084.  */
  4085. #define DDSCL_FULLSCREEN                        0x00000001l
  4086.  
  4087. /*
  4088.  * allow CTRL_ALT_DEL to work while in fullscreen exclusive mode
  4089.  */
  4090. #define DDSCL_ALLOWREBOOT                       0x00000002l
  4091.  
  4092. /*
  4093.  * prevents DDRAW from modifying the application window.
  4094.  * prevents DDRAW from minimize/restore the application window on activation.
  4095.  */
  4096. #define DDSCL_NOWINDOWCHANGES                   0x00000004l
  4097.  
  4098. /*
  4099.  * app wants to work as a regular Windows application
  4100.  */
  4101. #define DDSCL_NORMAL                            0x00000008l
  4102.  
  4103. /*
  4104.  * app wants exclusive access
  4105.  */
  4106. #define DDSCL_EXCLUSIVE                         0x00000010l
  4107.  
  4108.  
  4109. /*
  4110.  * app can deal with non-windows display modes
  4111.  */
  4112. #define DDSCL_ALLOWMODEX                        0x00000040l
  4113.  
  4114. /*
  4115.  * this window will receive the focus messages
  4116.  */
  4117. #define DDSCL_SETFOCUSWINDOW                    0x00000080l
  4118.  
  4119. /*
  4120.  * this window is associated with the DDRAW object and will
  4121.  * cover the screen in fullscreen mode
  4122.  */
  4123. #define DDSCL_SETDEVICEWINDOW                   0x00000100l
  4124.  
  4125. /*
  4126.  * app wants DDRAW to create a window to be associated with the
  4127.  * DDRAW object
  4128.  */
  4129. #define DDSCL_CREATEDEVICEWINDOW                0x00000200l
  4130.  
  4131. /*
  4132.  * App explicitly asks DDRAW/D3D to be multithread safe. This makes D3D
  4133.  * take the global crtisec more frequently.
  4134.  */
  4135. #define DDSCL_MULTITHREADED                     0x00000400l
  4136.  
  4137. /*
  4138.  * App specifies that it would like to keep the FPU set up for optimal Direct3D
  4139.  * performance (single precision and exceptions disabled) so Direct3D
  4140.  * does not need to explicitly set the FPU each time. This is assumed by
  4141.  * default in DirectX 7. See also DDSCL_FPUPRESERVE
  4142.  */
  4143. #define DDSCL_FPUSETUP                          0x00000800l
  4144.  
  4145. /*
  4146.  * App specifies that it needs either double precision FPU or FPU exceptions
  4147.  * enabled. This makes Direct3D explicitly set the FPU state eah time it is
  4148.  * called. Setting the flag will reduce Direct3D performance. The flag is
  4149.  * assumed by default in DirectX 6 and earlier. See also DDSCL_FPUSETUP
  4150.  */
  4151. #define DDSCL_FPUPRESERVE                          0x00001000l
  4152.  
  4153.  
  4154. /****************************************************************************
  4155.  *
  4156.  * DIRECTDRAW BLT FLAGS
  4157.  *
  4158.  ****************************************************************************/
  4159.  
  4160. /*
  4161.  * Use the alpha information in the pixel format or the alpha channel surface
  4162.  * attached to the destination surface as the alpha channel for this blt.
  4163.  */
  4164. #define DDBLT_ALPHADEST                         0x00000001l
  4165.  
  4166. /*
  4167.  * Use the dwConstAlphaDest field in the DDBLTFX structure as the alpha channel
  4168.  * for the destination surface for this blt.
  4169.  */
  4170. #define DDBLT_ALPHADESTCONSTOVERRIDE            0x00000002l
  4171.  
  4172. /*
  4173.  * The NEG suffix indicates that the destination surface becomes more
  4174.  * transparent as the alpha value increases. (0 is opaque)
  4175.  */
  4176. #define DDBLT_ALPHADESTNEG                      0x00000004l
  4177.  
  4178. /*
  4179.  * Use the lpDDSAlphaDest field in the DDBLTFX structure as the alpha
  4180.  * channel for the destination for this blt.
  4181.  */
  4182. #define DDBLT_ALPHADESTSURFACEOVERRIDE          0x00000008l
  4183.  
  4184. /*
  4185.  * Use the dwAlphaEdgeBlend field in the DDBLTFX structure as the alpha channel
  4186.  * for the edges of the image that border the color key colors.
  4187.  */
  4188. #define DDBLT_ALPHAEDGEBLEND                    0x00000010l
  4189.  
  4190. /*
  4191.  * Use the alpha information in the pixel format or the alpha channel surface
  4192.  * attached to the source surface as the alpha channel for this blt.
  4193.  */
  4194. #define DDBLT_ALPHASRC                          0x00000020l
  4195.  
  4196. /*
  4197.  * Use the dwConstAlphaSrc field in the DDBLTFX structure as the alpha channel
  4198.  * for the source for this blt.
  4199.  */
  4200. #define DDBLT_ALPHASRCCONSTOVERRIDE             0x00000040l
  4201.  
  4202. /*
  4203.  * The NEG suffix indicates that the source surface becomes more transparent
  4204.  * as the alpha value increases. (0 is opaque)
  4205.  */
  4206. #define DDBLT_ALPHASRCNEG                       0x00000080l
  4207.  
  4208. /*
  4209.  * Use the lpDDSAlphaSrc field in the DDBLTFX structure as the alpha channel
  4210.  * for the source for this blt.
  4211.  */
  4212. #define DDBLT_ALPHASRCSURFACEOVERRIDE           0x00000100l
  4213.  
  4214. /*
  4215.  * Do this blt asynchronously through the FIFO in the order received.  If
  4216.  * there is no room in the hardware FIFO fail the call.
  4217.  */
  4218. #define DDBLT_ASYNC                             0x00000200l
  4219.  
  4220. /*
  4221.  * Uses the dwFillColor field in the DDBLTFX structure as the RGB color
  4222.  * to fill the destination rectangle on the destination surface with.
  4223.  */
  4224. #define DDBLT_COLORFILL                         0x00000400l
  4225.  
  4226. /*
  4227.  * Uses the dwDDFX field in the DDBLTFX structure to specify the effects
  4228.  * to use for the blt.
  4229.  */
  4230. #define DDBLT_DDFX                              0x00000800l
  4231.  
  4232. /*
  4233.  * Uses the dwDDROPS field in the DDBLTFX structure to specify the ROPS
  4234.  * that are not part of the Win32 API.
  4235.  */
  4236. #define DDBLT_DDROPS                            0x00001000l
  4237.  
  4238. /*
  4239.  * Use the color key associated with the destination surface.
  4240.  */
  4241. #define DDBLT_KEYDEST                           0x00002000l
  4242.  
  4243. /*
  4244.  * Use the dckDestColorkey field in the DDBLTFX structure as the color key
  4245.  * for the destination surface.
  4246.  */
  4247. #define DDBLT_KEYDESTOVERRIDE                   0x00004000l
  4248.  
  4249. /*
  4250.  * Use the color key associated with the source surface.
  4251.  */
  4252. #define DDBLT_KEYSRC                            0x00008000l
  4253.  
  4254. /*
  4255.  * Use the dckSrcColorkey field in the DDBLTFX structure as the color key
  4256.  * for the source surface.
  4257.  */
  4258. #define DDBLT_KEYSRCOVERRIDE                    0x00010000l
  4259.  
  4260. /*
  4261.  * Use the dwROP field in the DDBLTFX structure for the raster operation
  4262.  * for this blt.  These ROPs are the same as the ones defined in the Win32 API.
  4263.  */
  4264. #define DDBLT_ROP                               0x00020000l
  4265.  
  4266. /*
  4267.  * Use the dwRotationAngle field in the DDBLTFX structure as the angle
  4268.  * (specified in 1/100th of a degree) to rotate the surface.
  4269.  */
  4270. #define DDBLT_ROTATIONANGLE                     0x00040000l
  4271.  
  4272. /*
  4273.  * Z-buffered blt using the z-buffers attached to the source and destination
  4274.  * surfaces and the dwZBufferOpCode field in the DDBLTFX structure as the
  4275.  * z-buffer opcode.
  4276.  */
  4277. #define DDBLT_ZBUFFER                           0x00080000l
  4278.  
  4279. /*
  4280.  * Z-buffered blt using the dwConstDest Zfield and the dwZBufferOpCode field
  4281.  * in the DDBLTFX structure as the z-buffer and z-buffer opcode respectively
  4282.  * for the destination.
  4283.  */
  4284. #define DDBLT_ZBUFFERDESTCONSTOVERRIDE          0x00100000l
  4285.  
  4286. /*
  4287.  * Z-buffered blt using the lpDDSDestZBuffer field and the dwZBufferOpCode
  4288.  * field in the DDBLTFX structure as the z-buffer and z-buffer opcode
  4289.  * respectively for the destination.
  4290.  */
  4291. #define DDBLT_ZBUFFERDESTOVERRIDE               0x00200000l
  4292.  
  4293. /*
  4294.  * Z-buffered blt using the dwConstSrcZ field and the dwZBufferOpCode field
  4295.  * in the DDBLTFX structure as the z-buffer and z-buffer opcode respectively
  4296.  * for the source.
  4297.  */
  4298. #define DDBLT_ZBUFFERSRCCONSTOVERRIDE           0x00400000l
  4299.  
  4300. /*
  4301.  * Z-buffered blt using the lpDDSSrcZBuffer field and the dwZBufferOpCode
  4302.  * field in the DDBLTFX structure as the z-buffer and z-buffer opcode
  4303.  * respectively for the source.
  4304.  */
  4305. #define DDBLT_ZBUFFERSRCOVERRIDE                0x00800000l
  4306.  
  4307. /*
  4308.  * wait until the device is ready to handle the blt
  4309.  * this will cause blt to not return DDERR_WASSTILLDRAWING
  4310.  */
  4311. #define DDBLT_WAIT                              0x01000000l
  4312.  
  4313. /*
  4314.  * Uses the dwFillDepth field in the DDBLTFX structure as the depth value
  4315.  * to fill the destination rectangle on the destination Z-buffer surface
  4316.  * with.
  4317.  */
  4318. #define DDBLT_DEPTHFILL                         0x02000000l
  4319.  
  4320.  
  4321. /*
  4322.  * wait until the device is ready to handle the blt
  4323.  * this will cause blt to not return DDERR_WASSTILLDRAWING
  4324.  */
  4325. #define DDBLT_DONOTWAIT                         0x08000000l
  4326.  
  4327. /*
  4328.  * These flags indicate a presentation blt (i.e. a blt
  4329.  * that moves surface contents from an offscreen back buffer to the primary
  4330.  * surface). The driver is not allowed to "queue"  more than three such blts.
  4331.  * The "end" of the presentation blt is indicated, since the
  4332.  * blt may be clipped, in which case the runtime will call the driver with 
  4333.  * several blts. All blts (even if not clipped) are tagged with DDBLT_PRESENTATION
  4334.  * and the last (even if not clipped) additionally with DDBLT_LAST_PRESENTATION.
  4335.  * Thus the true rule is that the driver must not schedule a DDBLT_PRESENTATION
  4336.  * blt if there are 3 or more DDBLT_PRESENTLAST blts in the hardware pipe.
  4337.  * If there are such blts in the pipe, the driver should return DDERR_WASSTILLDRAWING
  4338.  * until the oldest queued DDBLT_LAST_PRESENTATION blts has been retired (i.e. the
  4339.  * pixels have been actually written to the primary surface). Once the oldest blt
  4340.  * has been retired, the driver is free to schedule the current blt.
  4341.  * The goal is to provide a mechanism whereby the device's hardware queue never
  4342.  * gets more than 3 frames ahead of the frames being generated by the application.
  4343.  * When excessive queueing occurs, applications become unusable because the application
  4344.  * visibly lags user input, and such problems make windowed interactive applications impossible.
  4345.  * Some drivers may not have sufficient knowledge of their hardware's FIFO to know
  4346.  * when a certain blt has been retired. Such drivers should code cautiously, and 
  4347.  * simply not allow any frames to be queued at all. DDBLT_LAST_PRESENTATION should cause
  4348.  * such drivers to return DDERR_WASSTILLDRAWING until the accelerator is completely
  4349.  * finished- exactly as if the application had called Lock on the source surface
  4350.  * before calling Blt. 
  4351.  * In other words, the driver is allowed and encouraged to 
  4352.  * generate as much latency as it can, but never more than 3 frames worth.
  4353.  * Implementation detail: Drivers should count blts against the SOURCE surface, not
  4354.  * against the primary surface. This enables multiple parallel windowed application
  4355.  * to function more optimally.
  4356.  * This flag is passed only to DX8 or higher drivers.
  4357.  *
  4358.  * APPLICATIONS DO NOT SET THESE FLAGS. THEY ARE SET BY THE DIRECTDRAW RUNTIME.
  4359.  * 
  4360.  */
  4361. #define DDBLT_PRESENTATION                      0x10000000l
  4362. #define DDBLT_LAST_PRESENTATION                 0x20000000l
  4363.  
  4364.  
  4365.  
  4366. /****************************************************************************
  4367.  *
  4368.  * BLTFAST FLAGS
  4369.  *
  4370.  ****************************************************************************/
  4371.  
  4372. #define DDBLTFAST_NOCOLORKEY                    0x00000000
  4373. #define DDBLTFAST_SRCCOLORKEY                   0x00000001
  4374. #define DDBLTFAST_DESTCOLORKEY                  0x00000002
  4375. #define DDBLTFAST_WAIT                          0x00000010
  4376. #define DDBLTFAST_DONOTWAIT                     0x00000020
  4377.  
  4378. /****************************************************************************
  4379.  *
  4380.  * FLIP FLAGS
  4381.  *
  4382.  ****************************************************************************/
  4383.  
  4384. #define DDFLIP_WAIT                          0x00000001L
  4385.  
  4386. /*
  4387.  * Indicates that the target surface contains the even field of video data.
  4388.  * This flag is only valid with an overlay surface.
  4389.  */
  4390. #define DDFLIP_EVEN                          0x00000002L
  4391.  
  4392. /*
  4393.  * Indicates that the target surface contains the odd field of video data.
  4394.  * This flag is only valid with an overlay surface.
  4395.  */
  4396. #define DDFLIP_ODD                           0x00000004L
  4397.  
  4398. /*
  4399.  * Causes DirectDraw to perform the physical flip immediately and return
  4400.  * to the application. Typically, what was the front buffer but is now the back
  4401.  * buffer will still be visible (depending on timing) until the next vertical
  4402.  * retrace. Subsequent operations involving the two flipped surfaces will
  4403.  * not check to see if the physical flip has finished (i.e. will not return
  4404.  * DDERR_WASSTILLDRAWING for that reason (but may for other reasons)).
  4405.  * This allows an application to perform Flips at a higher frequency than the
  4406.  * monitor refresh rate, but may introduce visible artifacts.
  4407.  * Only effective if DDCAPS2_FLIPNOVSYNC is set. If that bit is not set,
  4408.  * DDFLIP_NOVSYNC has no effect.
  4409.  */
  4410. #define DDFLIP_NOVSYNC                       0x00000008L
  4411.  
  4412.  
  4413. /*
  4414.  * Flip Interval Flags. These flags indicate how many vertical retraces to wait between
  4415.  * each flip. The default is one. DirectDraw will return DDERR_WASSTILLDRAWING for each
  4416.  * surface involved in the flip until the specified number of vertical retraces has
  4417.  * ocurred. Only effective if DDCAPS2_FLIPINTERVAL is set. If that bit is not set,
  4418.  * DDFLIP_INTERVALn has no effect.
  4419.  */
  4420.  
  4421. /*
  4422.  * DirectDraw will flip on every other vertical sync
  4423.  */
  4424. #define DDFLIP_INTERVAL2                     0x02000000L
  4425.  
  4426.  
  4427. /*
  4428.  * DirectDraw will flip on every third vertical sync
  4429.  */
  4430. #define DDFLIP_INTERVAL3                     0x03000000L
  4431.  
  4432.  
  4433. /*
  4434.  * DirectDraw will flip on every fourth vertical sync
  4435.  */
  4436. #define DDFLIP_INTERVAL4                     0x04000000L
  4437.  
  4438. /*
  4439.  * DirectDraw will flip and display a main stereo surface
  4440.  */
  4441. #define DDFLIP_STEREO                        0x00000010L
  4442.  
  4443. /*
  4444.  * On IDirectDrawSurface7 and higher interfaces, the default is DDFLIP_WAIT. If you wish
  4445.  * to override the default and use time when the accelerator is busy (as denoted by
  4446.  * the DDERR_WASSTILLDRAWING return code) then use DDFLIP_DONOTWAIT.
  4447.  */
  4448. #define DDFLIP_DONOTWAIT                     0x00000020L
  4449.  
  4450.  
  4451. /****************************************************************************
  4452.  *
  4453.  * DIRECTDRAW SURFACE OVERLAY FLAGS
  4454.  *
  4455.  ****************************************************************************/
  4456.  
  4457. /*
  4458.  * Use the alpha information in the pixel format or the alpha channel surface
  4459.  * attached to the destination surface as the alpha channel for the
  4460.  * destination overlay.
  4461.  */
  4462. #define DDOVER_ALPHADEST                        0x00000001l
  4463.  
  4464. /*
  4465.  * Use the dwConstAlphaDest field in the DDOVERLAYFX structure as the
  4466.  * destination alpha channel for this overlay.
  4467.  */
  4468. #define DDOVER_ALPHADESTCONSTOVERRIDE           0x00000002l
  4469.  
  4470. /*
  4471.  * The NEG suffix indicates that the destination surface becomes more
  4472.  * transparent as the alpha value increases.
  4473.  */
  4474. #define DDOVER_ALPHADESTNEG                     0x00000004l
  4475.  
  4476. /*
  4477.  * Use the lpDDSAlphaDest field in the DDOVERLAYFX structure as the alpha
  4478.  * channel destination for this overlay.
  4479.  */
  4480. #define DDOVER_ALPHADESTSURFACEOVERRIDE         0x00000008l
  4481.  
  4482. /*
  4483.  * Use the dwAlphaEdgeBlend field in the DDOVERLAYFX structure as the alpha
  4484.  * channel for the edges of the image that border the color key colors.
  4485.  */
  4486. #define DDOVER_ALPHAEDGEBLEND                   0x00000010l
  4487.  
  4488. /*
  4489.  * Use the alpha information in the pixel format or the alpha channel surface
  4490.  * attached to the source surface as the source alpha channel for this overlay.
  4491.  */
  4492. #define DDOVER_ALPHASRC                         0x00000020l
  4493.  
  4494. /*
  4495.  * Use the dwConstAlphaSrc field in the DDOVERLAYFX structure as the source
  4496.  * alpha channel for this overlay.
  4497.  */
  4498. #define DDOVER_ALPHASRCCONSTOVERRIDE            0x00000040l
  4499.  
  4500. /*
  4501.  * The NEG suffix indicates that the source surface becomes more transparent
  4502.  * as the alpha value increases.
  4503.  */
  4504. #define DDOVER_ALPHASRCNEG                      0x00000080l
  4505.  
  4506. /*
  4507.  * Use the lpDDSAlphaSrc field in the DDOVERLAYFX structure as the alpha channel
  4508.  * source for this overlay.
  4509.  */
  4510. #define DDOVER_ALPHASRCSURFACEOVERRIDE          0x00000100l
  4511.  
  4512. /*
  4513.  * Turn this overlay off.
  4514.  */
  4515. #define DDOVER_HIDE                             0x00000200l
  4516.  
  4517. /*
  4518.  * Use the color key associated with the destination surface.
  4519.  */
  4520. #define DDOVER_KEYDEST                          0x00000400l
  4521.  
  4522. /*
  4523.  * Use the dckDestColorkey field in the DDOVERLAYFX structure as the color key
  4524.  * for the destination surface
  4525.  */
  4526. #define DDOVER_KEYDESTOVERRIDE                  0x00000800l
  4527.  
  4528. /*
  4529.  * Use the color key associated with the source surface.
  4530.  */
  4531. #define DDOVER_KEYSRC                           0x00001000l
  4532.  
  4533. /*
  4534.  * Use the dckSrcColorkey field in the DDOVERLAYFX structure as the color key
  4535.  * for the source surface.
  4536.  */
  4537. #define DDOVER_KEYSRCOVERRIDE                   0x00002000l
  4538.  
  4539. /*
  4540.  * Turn this overlay on.
  4541.  */
  4542. #define DDOVER_SHOW                             0x00004000l
  4543.  
  4544. /*
  4545.  * Add a dirty rect to an emulated overlayed surface.
  4546.  */
  4547. #define DDOVER_ADDDIRTYRECT                     0x00008000l
  4548.  
  4549. /*
  4550.  * Redraw all dirty rects on an emulated overlayed surface.
  4551.  */
  4552. #define DDOVER_REFRESHDIRTYRECTS                0x00010000l
  4553.  
  4554. /*
  4555.  * Redraw the entire surface on an emulated overlayed surface.
  4556.  */
  4557. #define DDOVER_REFRESHALL                      0x00020000l
  4558.  
  4559.  
  4560. /*
  4561.  * Use the overlay FX flags to define special overlay FX
  4562.  */
  4563. #define DDOVER_DDFX                             0x00080000l
  4564.  
  4565. /*
  4566.  * Autoflip the overlay when ever the video port autoflips
  4567.  */
  4568. #define DDOVER_AUTOFLIP                         0x00100000l
  4569.  
  4570. /*
  4571.  * Display each field of video port data individually without
  4572.  * causing any jittery artifacts
  4573.  */
  4574. #define DDOVER_BOB                              0x00200000l
  4575.  
  4576. /*
  4577.  * Indicates that bob/weave decisions should not be overridden by other
  4578.  * interfaces.
  4579.  */
  4580. #define DDOVER_OVERRIDEBOBWEAVE                 0x00400000l
  4581.  
  4582. /*
  4583.  * Indicates that the surface memory is composed of interleaved fields.
  4584.  */
  4585. #define DDOVER_INTERLEAVED                      0x00800000l
  4586.  
  4587. /*
  4588.  * Indicates that bob will be performed using hardware rather than
  4589.  * software or emulated.
  4590.  */
  4591. #define DDOVER_BOBHARDWARE                      0x01000000l
  4592.  
  4593. /*
  4594.  * Indicates that overlay FX structure contains valid ARGB scaling factors.
  4595.  */
  4596. #define DDOVER_ARGBSCALEFACTORS                 0x02000000l
  4597.  
  4598. /*
  4599.  * Indicates that ARGB scaling factors can be degraded to fit driver capabilities.
  4600.  */
  4601. #define DDOVER_DEGRADEARGBSCALING               0x04000000l
  4602.  
  4603.  
  4604. /****************************************************************************
  4605.  *
  4606.  * DIRECTDRAWSURFACE LOCK FLAGS
  4607.  *
  4608.  ****************************************************************************/
  4609.  
  4610. /*
  4611.  * The default.  Set to indicate that Lock should return a valid memory pointer
  4612.  * to the top of the specified rectangle.  If no rectangle is specified then a
  4613.  * pointer to the top of the surface is returned.
  4614.  */
  4615. #define DDLOCK_SURFACEMEMORYPTR                 0x00000000L     // default
  4616.  
  4617. /*
  4618.  * Set to indicate that Lock should wait until it can obtain a valid memory
  4619.  * pointer before returning.  If this bit is set, Lock will never return
  4620.  * DDERR_WASSTILLDRAWING.
  4621.  */
  4622. #define DDLOCK_WAIT                             0x00000001L
  4623.  
  4624. /*
  4625.  * Set if an event handle is being passed to Lock.  Lock will trigger the event
  4626.  * when it can return the surface memory pointer requested.
  4627.  */
  4628. #define DDLOCK_EVENT                            0x00000002L
  4629.  
  4630. /*
  4631.  * Indicates that the surface being locked will only be read from.
  4632.  */
  4633. #define DDLOCK_READONLY                         0x00000010L
  4634.  
  4635. /*
  4636.  * Indicates that the surface being locked will only be written to
  4637.  */
  4638. #define DDLOCK_WRITEONLY                        0x00000020L
  4639.  
  4640.  
  4641. /*
  4642.  * Indicates that a system wide lock should not be taken when this surface
  4643.  * is locked. This has several advantages (cursor responsiveness, ability
  4644.  * to call more Windows functions, easier debugging) when locking video
  4645.  * memory surfaces. However, an application specifying this flag must
  4646.  * comply with a number of conditions documented in the help file.
  4647.  * Furthermore, this flag cannot be specified when locking the primary.
  4648.  */
  4649. #define DDLOCK_NOSYSLOCK                        0x00000800L
  4650.  
  4651. /*
  4652.  * Used only with Direct3D Vertex Buffer Locks. Indicates that no vertices
  4653.  * that were referred to in Draw*PrimtiveVB calls since the start of the
  4654.  * frame (or the last lock without this flag) will be modified during the
  4655.  * lock. This can be useful when one is only appending data to the vertex
  4656.  * buffer
  4657.  */
  4658. #define DDLOCK_NOOVERWRITE                      0x00001000L
  4659.  
  4660. /*
  4661.  * Indicates that no assumptions will be made about the contents of the
  4662.  * surface or vertex buffer during this lock.
  4663.  * This enables two things:
  4664.  * -    Direct3D or the driver may provide an alternative memory
  4665.  *      area as the vertex buffer. This is useful when one plans to clear the
  4666.  *      contents of the vertex buffer and fill in new data.
  4667.  * -    Drivers sometimes store surface data in a re-ordered format.
  4668.  *      When the application locks the surface, the driver is forced to un-re-order
  4669.  *      the surface data before allowing the application to see the surface contents.
  4670.  *      This flag is a hint to the driver that it can skip the un-re-ordering process
  4671.  *      since the application plans to overwrite every single pixel in the surface
  4672.  *      or locked rectangle (and so erase any un-re-ordered pixels anyway).
  4673.  *      Applications should always set this flag when they intend to overwrite the entire
  4674.  *      surface or locked rectangle.
  4675.  */
  4676. #define DDLOCK_DISCARDCONTENTS                  0x00002000L
  4677.  /*
  4678.   * DDLOCK_OKTOSWAP is an older, less informative name for DDLOCK_DISCARDCONTENTS
  4679.   */
  4680. #define DDLOCK_OKTOSWAP                         0x00002000L
  4681.  
  4682. /*
  4683.  * On IDirectDrawSurface7 and higher interfaces, the default is DDLOCK_WAIT. If you wish
  4684.  * to override the default and use time when the accelerator is busy (as denoted by
  4685.  * the DDERR_WASSTILLDRAWING return code) then use DDLOCK_DONOTWAIT.
  4686.  */
  4687. #define DDLOCK_DONOTWAIT                        0x00004000L
  4688.  
  4689.  
  4690.  
  4691. /****************************************************************************
  4692.  *
  4693.  * DIRECTDRAWSURFACE PAGELOCK FLAGS
  4694.  *
  4695.  ****************************************************************************/
  4696.  
  4697. /*
  4698.  * No flags defined at present
  4699.  */
  4700.  
  4701.  
  4702. /****************************************************************************
  4703.  *
  4704.  * DIRECTDRAWSURFACE PAGEUNLOCK FLAGS
  4705.  *
  4706.  ****************************************************************************/
  4707.  
  4708. /*
  4709.  * No flags defined at present
  4710.  */
  4711.  
  4712.  
  4713. /****************************************************************************
  4714.  *
  4715.  * DIRECTDRAWSURFACE BLT FX FLAGS
  4716.  *
  4717.  ****************************************************************************/
  4718.  
  4719. /*
  4720.  * If stretching, use arithmetic stretching along the Y axis for this blt.
  4721.  */
  4722. #define DDBLTFX_ARITHSTRETCHY                   0x00000001l
  4723.  
  4724. /*
  4725.  * Do this blt mirroring the surface left to right.  Spin the
  4726.  * surface around its y-axis.
  4727.  */
  4728. #define DDBLTFX_MIRRORLEFTRIGHT                 0x00000002l
  4729.  
  4730. /*
  4731.  * Do this blt mirroring the surface up and down.  Spin the surface
  4732.  * around its x-axis.
  4733.  */
  4734. #define DDBLTFX_MIRRORUPDOWN                    0x00000004l
  4735.  
  4736. /*
  4737.  * Schedule this blt to avoid tearing.
  4738.  */
  4739. #define DDBLTFX_NOTEARING                       0x00000008l
  4740.  
  4741. /*
  4742.  * Do this blt rotating the surface one hundred and eighty degrees.
  4743.  */
  4744. #define DDBLTFX_ROTATE180                       0x00000010l
  4745.  
  4746. /*
  4747.  * Do this blt rotating the surface two hundred and seventy degrees.
  4748.  */
  4749. #define DDBLTFX_ROTATE270                       0x00000020l
  4750.  
  4751. /*
  4752.  * Do this blt rotating the surface ninety degrees.
  4753.  */
  4754. #define DDBLTFX_ROTATE90                        0x00000040l
  4755.  
  4756. /*
  4757.  * Do this z blt using dwZBufferLow and dwZBufferHigh as  range values
  4758.  * specified to limit the bits copied from the source surface.
  4759.  */
  4760. #define DDBLTFX_ZBUFFERRANGE                    0x00000080l
  4761.  
  4762. /*
  4763.  * Do this z blt adding the dwZBufferBaseDest to each of the sources z values
  4764.  * before comparing it with the desting z values.
  4765.  */
  4766. #define DDBLTFX_ZBUFFERBASEDEST                 0x00000100l
  4767.  
  4768. /****************************************************************************
  4769.  *
  4770.  * DIRECTDRAWSURFACE OVERLAY FX FLAGS
  4771.  *
  4772.  ****************************************************************************/
  4773.  
  4774. /*
  4775.  * If stretching, use arithmetic stretching along the Y axis for this overlay.
  4776.  */
  4777. #define DDOVERFX_ARITHSTRETCHY                  0x00000001l
  4778.  
  4779. /*
  4780.  * Mirror the overlay across the vertical axis
  4781.  */
  4782. #define DDOVERFX_MIRRORLEFTRIGHT                0x00000002l
  4783.  
  4784. /*
  4785.  * Mirror the overlay across the horizontal axis
  4786.  */
  4787. #define DDOVERFX_MIRRORUPDOWN                   0x00000004l
  4788.  
  4789. /*
  4790.  * Deinterlace the overlay, if possible
  4791.  */
  4792. #define DDOVERFX_DEINTERLACE                    0x00000008l
  4793.  
  4794.  
  4795. /****************************************************************************
  4796.  *
  4797.  * DIRECTDRAW WAITFORVERTICALBLANK FLAGS
  4798.  *
  4799.  ****************************************************************************/
  4800.  
  4801. /*
  4802.  * return when the vertical blank interval begins
  4803.  */
  4804. #define DDWAITVB_BLOCKBEGIN                     0x00000001l
  4805.  
  4806. /*
  4807.  * set up an event to trigger when the vertical blank begins
  4808.  */
  4809. #define DDWAITVB_BLOCKBEGINEVENT                0x00000002l
  4810.  
  4811. /*
  4812.  * return when the vertical blank interval ends and display begins
  4813.  */
  4814. #define DDWAITVB_BLOCKEND                       0x00000004l
  4815.  
  4816. /****************************************************************************
  4817.  *
  4818.  * DIRECTDRAW GETFLIPSTATUS FLAGS
  4819.  *
  4820.  ****************************************************************************/
  4821.  
  4822. /*
  4823.  * is it OK to flip now?
  4824.  */
  4825. #define DDGFS_CANFLIP                   0x00000001l
  4826.  
  4827. /*
  4828.  * is the last flip finished?
  4829.  */
  4830. #define DDGFS_ISFLIPDONE                0x00000002l
  4831.  
  4832. /****************************************************************************
  4833.  *
  4834.  * DIRECTDRAW GETBLTSTATUS FLAGS
  4835.  *
  4836.  ****************************************************************************/
  4837.  
  4838. /*
  4839.  * is it OK to blt now?
  4840.  */
  4841. #define DDGBS_CANBLT                    0x00000001l
  4842.  
  4843. /*
  4844.  * is the blt to the surface finished?
  4845.  */
  4846. #define DDGBS_ISBLTDONE                 0x00000002l
  4847.  
  4848.  
  4849. /****************************************************************************
  4850.  *
  4851.  * DIRECTDRAW ENUMOVERLAYZORDER FLAGS
  4852.  *
  4853.  ****************************************************************************/
  4854.  
  4855. /*
  4856.  * Enumerate overlays back to front.
  4857.  */
  4858. #define DDENUMOVERLAYZ_BACKTOFRONT      0x00000000l
  4859.  
  4860. /*
  4861.  * Enumerate overlays front to back
  4862.  */
  4863. #define DDENUMOVERLAYZ_FRONTTOBACK      0x00000001l
  4864.  
  4865. /****************************************************************************
  4866.  *
  4867.  * DIRECTDRAW UPDATEOVERLAYZORDER FLAGS
  4868.  *
  4869.  ****************************************************************************/
  4870.  
  4871. /*
  4872.  * Send overlay to front
  4873.  */
  4874. #define DDOVERZ_SENDTOFRONT             0x00000000l
  4875.  
  4876. /*
  4877.  * Send overlay to back
  4878.  */
  4879. #define DDOVERZ_SENDTOBACK              0x00000001l
  4880.  
  4881. /*
  4882.  * Move Overlay forward
  4883.  */
  4884. #define DDOVERZ_MOVEFORWARD             0x00000002l
  4885.  
  4886. /*
  4887.  * Move Overlay backward
  4888.  */
  4889. #define DDOVERZ_MOVEBACKWARD            0x00000003l
  4890.  
  4891. /*
  4892.  * Move Overlay in front of relative surface
  4893.  */
  4894. #define DDOVERZ_INSERTINFRONTOF         0x00000004l
  4895.  
  4896. /*
  4897.  * Move Overlay in back of relative surface
  4898.  */
  4899. #define DDOVERZ_INSERTINBACKOF          0x00000005l
  4900.  
  4901.  
  4902. /****************************************************************************
  4903.  *
  4904.  * DIRECTDRAW SETGAMMARAMP FLAGS
  4905.  *
  4906.  ****************************************************************************/
  4907.  
  4908. /*
  4909.  * Request calibrator to adjust the gamma ramp according to the physical
  4910.  * properties of the display so that the result should appear identical
  4911.  * on all systems.
  4912.  */
  4913. #define DDSGR_CALIBRATE                        0x00000001L
  4914.  
  4915.  
  4916. /****************************************************************************
  4917.  *
  4918.  * DIRECTDRAW STARTMODETEST FLAGS
  4919.  *
  4920.  ****************************************************************************/
  4921.  
  4922. /*
  4923.  * Indicates that the mode being tested has passed
  4924.  */
  4925. #define DDSMT_ISTESTREQUIRED                   0x00000001L
  4926.  
  4927.  
  4928. /****************************************************************************
  4929.  *
  4930.  * DIRECTDRAW EVALUATEMODE FLAGS
  4931.  *
  4932.  ****************************************************************************/
  4933.  
  4934. /*
  4935.  * Indicates that the mode being tested has passed
  4936.  */
  4937. #define DDEM_MODEPASSED                        0x00000001L
  4938.  
  4939. /*
  4940.  * Indicates that the mode being tested has failed
  4941.  */
  4942. #define DDEM_MODEFAILED                        0x00000002L
  4943.  
  4944.  
  4945. /*===========================================================================
  4946.  *
  4947.  *
  4948.  * DIRECTDRAW RETURN CODES
  4949.  *
  4950.  * The return values from DirectDraw Commands and Surface that return an HRESULT
  4951.  * are codes from DirectDraw concerning the results of the action
  4952.  * requested by DirectDraw.
  4953.  *
  4954.  *==========================================================================*/
  4955.  
  4956. /*
  4957.  * Status is OK
  4958.  *
  4959.  * Issued by: DirectDraw Commands and all callbacks
  4960.  */
  4961. #define DD_OK                                   0
  4962. #define DD_FALSE                                S_FALSE
  4963.  
  4964. /****************************************************************************
  4965.  *
  4966.  * DIRECTDRAW ENUMCALLBACK RETURN VALUES
  4967.  *
  4968.  * EnumCallback returns are used to control the flow of the DIRECTDRAW and
  4969.  * DIRECTDRAWSURFACE object enumerations.   They can only be returned by
  4970.  * enumeration callback routines.
  4971.  *
  4972.  ****************************************************************************/
  4973.  
  4974. /*
  4975.  * stop the enumeration
  4976.  */
  4977. #define DDENUMRET_CANCEL                        0
  4978.  
  4979. /*
  4980.  * continue the enumeration
  4981.  */
  4982. #define DDENUMRET_OK                            1
  4983.  
  4984. /****************************************************************************
  4985.  *
  4986.  * DIRECTDRAW ERRORS
  4987.  *
  4988.  * Errors are represented by negative values and cannot be combined.
  4989.  *
  4990.  ****************************************************************************/
  4991.  
  4992. /*
  4993.  * This object is already initialized
  4994.  */
  4995. #define DDERR_ALREADYINITIALIZED                MAKE_DDHRESULT( 5 )
  4996.  
  4997. /*
  4998.  * This surface can not be attached to the requested surface.
  4999.  */
  5000. #define DDERR_CANNOTATTACHSURFACE               MAKE_DDHRESULT( 10 )
  5001.  
  5002. /*
  5003.  * This surface can not be detached from the requested surface.
  5004.  */
  5005. #define DDERR_CANNOTDETACHSURFACE               MAKE_DDHRESULT( 20 )
  5006.  
  5007. /*
  5008.  * Support is currently not available.
  5009.  */
  5010. #define DDERR_CURRENTLYNOTAVAIL                 MAKE_DDHRESULT( 40 )
  5011.  
  5012. /*
  5013.  * An exception was encountered while performing the requested operation
  5014.  */
  5015. #define DDERR_EXCEPTION                         MAKE_DDHRESULT( 55 )
  5016.  
  5017. /*
  5018.  * Generic failure.
  5019.  */
  5020. #define DDERR_GENERIC                           E_FAIL
  5021.  
  5022. /*
  5023.  * Height of rectangle provided is not a multiple of reqd alignment
  5024.  */
  5025. #define DDERR_HEIGHTALIGN                       MAKE_DDHRESULT( 90 )
  5026.  
  5027. /*
  5028.  * Unable to match primary surface creation request with existing
  5029.  * primary surface.
  5030.  */
  5031. #define DDERR_INCOMPATIBLEPRIMARY               MAKE_DDHRESULT( 95 )
  5032.  
  5033. /*
  5034.  * One or more of the caps bits passed to the callback are incorrect.
  5035.  */
  5036. #define DDERR_INVALIDCAPS                       MAKE_DDHRESULT( 100 )
  5037.  
  5038. /*
  5039.  * DirectDraw does not support provided Cliplist.
  5040.  */
  5041. #define DDERR_INVALIDCLIPLIST                   MAKE_DDHRESULT( 110 )
  5042.  
  5043. /*
  5044.  * DirectDraw does not support the requested mode
  5045.  */
  5046. #define DDERR_INVALIDMODE                       MAKE_DDHRESULT( 120 )
  5047.  
  5048. /*
  5049.  * DirectDraw received a pointer that was an invalid DIRECTDRAW object.
  5050.  */
  5051. #define DDERR_INVALIDOBJECT                     MAKE_DDHRESULT( 130 )
  5052.  
  5053. /*
  5054.  * One or more of the parameters passed to the callback function are
  5055.  * incorrect.
  5056.  */
  5057. #define DDERR_INVALIDPARAMS                     E_INVALIDARG
  5058.  
  5059. /*
  5060.  * pixel format was invalid as specified
  5061.  */
  5062. #define DDERR_INVALIDPIXELFORMAT                MAKE_DDHRESULT( 145 )
  5063.  
  5064. /*
  5065.  * Rectangle provided was invalid.
  5066.  */
  5067. #define DDERR_INVALIDRECT                       MAKE_DDHRESULT( 150 )
  5068.  
  5069. /*
  5070.  * Operation could not be carried out because one or more surfaces are locked
  5071.  */
  5072. #define DDERR_LOCKEDSURFACES                    MAKE_DDHRESULT( 160 )
  5073.  
  5074. /*
  5075.  * There is no 3D present.
  5076.  */
  5077. #define DDERR_NO3D                              MAKE_DDHRESULT( 170 )
  5078.  
  5079. /*
  5080.  * Operation could not be carried out because there is no alpha accleration
  5081.  * hardware present or available.
  5082.  */
  5083. #define DDERR_NOALPHAHW                         MAKE_DDHRESULT( 180 )
  5084.  
  5085. /*
  5086.  * Operation could not be carried out because there is no stereo
  5087.  * hardware present or available.
  5088.  */
  5089. #define DDERR_NOSTEREOHARDWARE          MAKE_DDHRESULT( 181 )
  5090.  
  5091. /*
  5092.  * Operation could not be carried out because there is no hardware
  5093.  * present which supports stereo surfaces
  5094.  */
  5095. #define DDERR_NOSURFACELEFT                             MAKE_DDHRESULT( 182 )
  5096.  
  5097.  
  5098.  
  5099. /*
  5100.  * no clip list available
  5101.  */
  5102. #define DDERR_NOCLIPLIST                        MAKE_DDHRESULT( 205 )
  5103.  
  5104. /*
  5105.  * Operation could not be carried out because there is no color conversion
  5106.  * hardware present or available.
  5107.  */
  5108. #define DDERR_NOCOLORCONVHW                     MAKE_DDHRESULT( 210 )
  5109.  
  5110. /*
  5111.  * Create function called without DirectDraw object method SetCooperativeLevel
  5112.  * being called.
  5113.  */
  5114. #define DDERR_NOCOOPERATIVELEVELSET             MAKE_DDHRESULT( 212 )
  5115.  
  5116. /*
  5117.  * Surface doesn't currently have a color key
  5118.  */
  5119. #define DDERR_NOCOLORKEY                        MAKE_DDHRESULT( 215 )
  5120.  
  5121. /*
  5122.  * Operation could not be carried out because there is no hardware support
  5123.  * of the dest color key.
  5124.  */
  5125. #define DDERR_NOCOLORKEYHW                      MAKE_DDHRESULT( 220 )
  5126.  
  5127. /*
  5128.  * No DirectDraw support possible with current display driver
  5129.  */
  5130. #define DDERR_NODIRECTDRAWSUPPORT               MAKE_DDHRESULT( 222 )
  5131.  
  5132. /*
  5133.  * Operation requires the application to have exclusive mode but the
  5134.  * application does not have exclusive mode.
  5135.  */
  5136. #define DDERR_NOEXCLUSIVEMODE                   MAKE_DDHRESULT( 225 )
  5137.  
  5138. /*
  5139.  * Flipping visible surfaces is not supported.
  5140.  */
  5141. #define DDERR_NOFLIPHW                          MAKE_DDHRESULT( 230 )
  5142.  
  5143. /*
  5144.  * There is no GDI present.
  5145.  */
  5146. #define DDERR_NOGDI                             MAKE_DDHRESULT( 240 )
  5147.  
  5148. /*
  5149.  * Operation could not be carried out because there is no hardware present
  5150.  * or available.
  5151.  */
  5152. #define DDERR_NOMIRRORHW                        MAKE_DDHRESULT( 250 )
  5153.  
  5154. /*
  5155.  * Requested item was not found
  5156.  */
  5157. #define DDERR_NOTFOUND                          MAKE_DDHRESULT( 255 )
  5158.  
  5159. /*
  5160.  * Operation could not be carried out because there is no overlay hardware
  5161.  * present or available.
  5162.  */
  5163. #define DDERR_NOOVERLAYHW                       MAKE_DDHRESULT( 260 )
  5164.  
  5165. /*
  5166.  * Operation could not be carried out because the source and destination
  5167.  * rectangles are on the same surface and overlap each other.
  5168.  */
  5169. #define DDERR_OVERLAPPINGRECTS                  MAKE_DDHRESULT( 270 )
  5170.  
  5171. /*
  5172.  * Operation could not be carried out because there is no appropriate raster
  5173.  * op hardware present or available.
  5174.  */
  5175. #define DDERR_NORASTEROPHW                      MAKE_DDHRESULT( 280 )
  5176.  
  5177. /*
  5178.  * Operation could not be carried out because there is no rotation hardware
  5179.  * present or available.
  5180.  */
  5181. #define DDERR_NOROTATIONHW                      MAKE_DDHRESULT( 290 )
  5182.  
  5183. /*
  5184.  * Operation could not be carried out because there is no hardware support
  5185.  * for stretching
  5186.  */
  5187. #define DDERR_NOSTRETCHHW                       MAKE_DDHRESULT( 310 )
  5188.  
  5189. /*
  5190.  * DirectDrawSurface is not in 4 bit color palette and the requested operation
  5191.  * requires 4 bit color palette.
  5192.  */
  5193. #define DDERR_NOT4BITCOLOR                      MAKE_DDHRESULT( 316 )
  5194.  
  5195. /*
  5196.  * DirectDrawSurface is not in 4 bit color index palette and the requested
  5197.  * operation requires 4 bit color index palette.
  5198.  */
  5199. #define DDERR_NOT4BITCOLORINDEX                 MAKE_DDHRESULT( 317 )
  5200.  
  5201. /*
  5202.  * DirectDraw Surface is not in 8 bit color mode and the requested operation
  5203.  * requires 8 bit color.
  5204.  */
  5205. #define DDERR_NOT8BITCOLOR                      MAKE_DDHRESULT( 320 )
  5206.  
  5207. /*
  5208.  * Operation could not be carried out because there is no texture mapping
  5209.  * hardware present or available.
  5210.  */
  5211. #define DDERR_NOTEXTUREHW                       MAKE_DDHRESULT( 330 )
  5212.  
  5213. /*
  5214.  * Operation could not be carried out because there is no hardware support
  5215.  * for vertical blank synchronized operations.
  5216.  */
  5217. #define DDERR_NOVSYNCHW                         MAKE_DDHRESULT( 335 )
  5218.  
  5219. /*
  5220.  * Operation could not be carried out because there is no hardware support
  5221.  * for zbuffer blting.
  5222.  */
  5223. #define DDERR_NOZBUFFERHW                       MAKE_DDHRESULT( 340 )
  5224.  
  5225. /*
  5226.  * Overlay surfaces could not be z layered based on their BltOrder because
  5227.  * the hardware does not support z layering of overlays.
  5228.  */
  5229. #define DDERR_NOZOVERLAYHW                      MAKE_DDHRESULT( 350 )
  5230.  
  5231. /*
  5232.  * The hardware needed for the requested operation has already been
  5233.  * allocated.
  5234.  */
  5235. #define DDERR_OUTOFCAPS                         MAKE_DDHRESULT( 360 )
  5236.  
  5237. /*
  5238.  * DirectDraw does not have enough memory to perform the operation.
  5239.  */
  5240. #define DDERR_OUTOFMEMORY                       E_OUTOFMEMORY
  5241.  
  5242. /*
  5243.  * DirectDraw does not have enough memory to perform the operation.
  5244.  */
  5245. #define DDERR_OUTOFVIDEOMEMORY                  MAKE_DDHRESULT( 380 )
  5246.  
  5247. /*
  5248.  * hardware does not support clipped overlays
  5249.  */
  5250. #define DDERR_OVERLAYCANTCLIP                   MAKE_DDHRESULT( 382 )
  5251.  
  5252. /*
  5253.  * Can only have ony color key active at one time for overlays
  5254.  */
  5255. #define DDERR_OVERLAYCOLORKEYONLYONEACTIVE      MAKE_DDHRESULT( 384 )
  5256.  
  5257. /*
  5258.  * Access to this palette is being refused because the palette is already
  5259.  * locked by another thread.
  5260.  */
  5261. #define DDERR_PALETTEBUSY                       MAKE_DDHRESULT( 387 )
  5262.  
  5263. /*
  5264.  * No src color key specified for this operation.
  5265.  */
  5266. #define DDERR_COLORKEYNOTSET                    MAKE_DDHRESULT( 400 )
  5267.  
  5268. /*
  5269.  * This surface is already attached to the surface it is being attached to.
  5270.  */
  5271. #define DDERR_SURFACEALREADYATTACHED            MAKE_DDHRESULT( 410 )
  5272.  
  5273. /*
  5274.  * This surface is already a dependency of the surface it is being made a
  5275.  * dependency of.
  5276.  */
  5277. #define DDERR_SURFACEALREADYDEPENDENT           MAKE_DDHRESULT( 420 )
  5278.  
  5279. /*
  5280.  * Access to this surface is being refused because the surface is already
  5281.  * locked by another thread.
  5282.  */
  5283. #define DDERR_SURFACEBUSY                       MAKE_DDHRESULT( 430 )
  5284.  
  5285. /*
  5286.  * Access to this surface is being refused because no driver exists
  5287.  * which can supply a pointer to the surface.
  5288.  * This is most likely to happen when attempting to lock the primary
  5289.  * surface when no DCI provider is present.
  5290.  * Will also happen on attempts to lock an optimized surface.
  5291.  */
  5292. #define DDERR_CANTLOCKSURFACE                   MAKE_DDHRESULT( 435 )
  5293.  
  5294. /*
  5295.  * Access to Surface refused because Surface is obscured.
  5296.  */
  5297. #define DDERR_SURFACEISOBSCURED                 MAKE_DDHRESULT( 440 )
  5298.  
  5299. /*
  5300.  * Access to this surface is being refused because the surface is gone.
  5301.  * The DIRECTDRAWSURFACE object representing this surface should
  5302.  * have Restore called on it.
  5303.  */
  5304. #define DDERR_SURFACELOST                       MAKE_DDHRESULT( 450 )
  5305.  
  5306. /*
  5307.  * The requested surface is not attached.
  5308.  */
  5309. #define DDERR_SURFACENOTATTACHED                MAKE_DDHRESULT( 460 )
  5310.  
  5311. /*
  5312.  * Height requested by DirectDraw is too large.
  5313.  */
  5314. #define DDERR_TOOBIGHEIGHT                      MAKE_DDHRESULT( 470 )
  5315.  
  5316. /*
  5317.  * Size requested by DirectDraw is too large --  The individual height and
  5318.  * width are OK.
  5319.  */
  5320. #define DDERR_TOOBIGSIZE                        MAKE_DDHRESULT( 480 )
  5321.  
  5322. /*
  5323.  * Width requested by DirectDraw is too large.
  5324.  */
  5325. #define DDERR_TOOBIGWIDTH                       MAKE_DDHRESULT( 490 )
  5326.  
  5327. /*
  5328.  * Action not supported.
  5329.  */
  5330. #define DDERR_UNSUPPORTED                       E_NOTIMPL
  5331.  
  5332. /*
  5333.  * Pixel format requested is unsupported by DirectDraw
  5334.  */
  5335. #define DDERR_UNSUPPORTEDFORMAT                 MAKE_DDHRESULT( 510 )
  5336.  
  5337. /*
  5338.  * Bitmask in the pixel format requested is unsupported by DirectDraw
  5339.  */
  5340. #define DDERR_UNSUPPORTEDMASK                   MAKE_DDHRESULT( 520 )
  5341.  
  5342. /*
  5343.  * The specified stream contains invalid data
  5344.  */
  5345. #define DDERR_INVALIDSTREAM                     MAKE_DDHRESULT( 521 )
  5346.  
  5347. /*
  5348.  * vertical blank is in progress
  5349.  */
  5350. #define DDERR_VERTICALBLANKINPROGRESS           MAKE_DDHRESULT( 537 )
  5351.  
  5352. /*
  5353.  * Informs DirectDraw that the previous Blt which is transfering information
  5354.  * to or from this Surface is incomplete.
  5355.  */
  5356. #define DDERR_WASSTILLDRAWING                   MAKE_DDHRESULT( 540 )
  5357.  
  5358.  
  5359. /*
  5360.  * The specified surface type requires specification of the COMPLEX flag
  5361.  */
  5362. #define DDERR_DDSCAPSCOMPLEXREQUIRED            MAKE_DDHRESULT( 542 )
  5363.  
  5364.  
  5365. /*
  5366.  * Rectangle provided was not horizontally aligned on reqd. boundary
  5367.  */
  5368. #define DDERR_XALIGN                            MAKE_DDHRESULT( 560 )
  5369.  
  5370. /*
  5371.  * The GUID passed to DirectDrawCreate is not a valid DirectDraw driver
  5372.  * identifier.
  5373.  */
  5374. #define DDERR_INVALIDDIRECTDRAWGUID             MAKE_DDHRESULT( 561 )
  5375.  
  5376. /*
  5377.  * A DirectDraw object representing this driver has already been created
  5378.  * for this process.
  5379.  */
  5380. #define DDERR_DIRECTDRAWALREADYCREATED          MAKE_DDHRESULT( 562 )
  5381.  
  5382. /*
  5383.  * A hardware only DirectDraw object creation was attempted but the driver
  5384.  * did not support any hardware.
  5385.  */
  5386. #define DDERR_NODIRECTDRAWHW                    MAKE_DDHRESULT( 563 )
  5387.  
  5388. /*
  5389.  * this process already has created a primary surface
  5390.  */
  5391. #define DDERR_PRIMARYSURFACEALREADYEXISTS       MAKE_DDHRESULT( 564 )
  5392.  
  5393. /*
  5394.  * software emulation not available.
  5395.  */
  5396. #define DDERR_NOEMULATION                       MAKE_DDHRESULT( 565 )
  5397.  
  5398. /*
  5399.  * region passed to Clipper::GetClipList is too small.
  5400.  */
  5401. #define DDERR_REGIONTOOSMALL                    MAKE_DDHRESULT( 566 )
  5402.  
  5403. /*
  5404.  * an attempt was made to set a clip list for a clipper objec that
  5405.  * is already monitoring an hwnd.
  5406.  */
  5407. #define DDERR_CLIPPERISUSINGHWND                MAKE_DDHRESULT( 567 )
  5408.  
  5409. /*
  5410.  * No clipper object attached to surface object
  5411.  */
  5412. #define DDERR_NOCLIPPERATTACHED                 MAKE_DDHRESULT( 568 )
  5413.  
  5414. /*
  5415.  * Clipper notification requires an HWND or
  5416.  * no HWND has previously been set as the CooperativeLevel HWND.
  5417.  */
  5418. #define DDERR_NOHWND                            MAKE_DDHRESULT( 569 )
  5419.  
  5420. /*
  5421.  * HWND used by DirectDraw CooperativeLevel has been subclassed,
  5422.  * this prevents DirectDraw from restoring state.
  5423.  */
  5424. #define DDERR_HWNDSUBCLASSED                    MAKE_DDHRESULT( 570 )
  5425.  
  5426. /*
  5427.  * The CooperativeLevel HWND has already been set.
  5428.  * It can not be reset while the process has surfaces or palettes created.
  5429.  */
  5430. #define DDERR_HWNDALREADYSET                    MAKE_DDHRESULT( 571 )
  5431.  
  5432. /*
  5433.  * No palette object attached to this surface.
  5434.  */
  5435. #define DDERR_NOPALETTEATTACHED                 MAKE_DDHRESULT( 572 )
  5436.  
  5437. /*
  5438.  * No hardware support for 16 or 256 color palettes.
  5439.  */
  5440. #define DDERR_NOPALETTEHW                       MAKE_DDHRESULT( 573 )
  5441.  
  5442. /*
  5443.  * If a clipper object is attached to the source surface passed into a
  5444.  * BltFast call.
  5445.  */
  5446. #define DDERR_BLTFASTCANTCLIP                   MAKE_DDHRESULT( 574 )
  5447.  
  5448. /*
  5449.  * No blter.
  5450.  */
  5451. #define DDERR_NOBLTHW                           MAKE_DDHRESULT( 575 )
  5452.  
  5453. /*
  5454.  * No DirectDraw ROP hardware.
  5455.  */
  5456. #define DDERR_NODDROPSHW                        MAKE_DDHRESULT( 576 )
  5457.  
  5458. /*
  5459.  * returned when GetOverlayPosition is called on a hidden overlay
  5460.  */
  5461. #define DDERR_OVERLAYNOTVISIBLE                 MAKE_DDHRESULT( 577 )
  5462.  
  5463. /*
  5464.  * returned when GetOverlayPosition is called on a overlay that UpdateOverlay
  5465.  * has never been called on to establish a destionation.
  5466.  */
  5467. #define DDERR_NOOVERLAYDEST                     MAKE_DDHRESULT( 578 )
  5468.  
  5469. /*
  5470.  * returned when the position of the overlay on the destionation is no longer
  5471.  * legal for that destionation.
  5472.  */
  5473. #define DDERR_INVALIDPOSITION                   MAKE_DDHRESULT( 579 )
  5474.  
  5475. /*
  5476.  * returned when an overlay member is called for a non-overlay surface
  5477.  */
  5478. #define DDERR_NOTAOVERLAYSURFACE                MAKE_DDHRESULT( 580 )
  5479.  
  5480. /*
  5481.  * An attempt was made to set the cooperative level when it was already
  5482.  * set to exclusive.
  5483.  */
  5484. #define DDERR_EXCLUSIVEMODEALREADYSET           MAKE_DDHRESULT( 581 )
  5485.  
  5486. /*
  5487.  * An attempt has been made to flip a surface that is not flippable.
  5488.  */
  5489. #define DDERR_NOTFLIPPABLE                      MAKE_DDHRESULT( 582 )
  5490.  
  5491. /*
  5492.  * Can't duplicate primary & 3D surfaces, or surfaces that are implicitly
  5493.  * created.
  5494.  */
  5495. #define DDERR_CANTDUPLICATE                     MAKE_DDHRESULT( 583 )
  5496.  
  5497. /*
  5498.  * Surface was not locked.  An attempt to unlock a surface that was not
  5499.  * locked at all, or by this process, has been attempted.
  5500.  */
  5501. #define DDERR_NOTLOCKED                         MAKE_DDHRESULT( 584 )
  5502.  
  5503. /*
  5504.  * Windows can not create any more DCs, or a DC was requested for a paltte-indexed
  5505.  * surface when the surface had no palette AND the display mode was not palette-indexed
  5506.  * (in this case DirectDraw cannot select a proper palette into the DC)
  5507.  */
  5508. #define DDERR_CANTCREATEDC                      MAKE_DDHRESULT( 585 )
  5509.  
  5510. /*
  5511.  * No DC was ever created for this surface.
  5512.  */
  5513. #define DDERR_NODC                              MAKE_DDHRESULT( 586 )
  5514.  
  5515. /*
  5516.  * This surface can not be restored because it was created in a different
  5517.  * mode.
  5518.  */
  5519. #define DDERR_WRONGMODE                         MAKE_DDHRESULT( 587 )
  5520.  
  5521. /*
  5522.  * This surface can not be restored because it is an implicitly created
  5523.  * surface.
  5524.  */
  5525. #define DDERR_IMPLICITLYCREATED                 MAKE_DDHRESULT( 588 )
  5526.  
  5527. /*
  5528.  * The surface being used is not a palette-based surface
  5529.  */
  5530. #define DDERR_NOTPALETTIZED                     MAKE_DDHRESULT( 589 )
  5531.  
  5532.  
  5533. /*
  5534.  * The display is currently in an unsupported mode
  5535.  */
  5536. #define DDERR_UNSUPPORTEDMODE                   MAKE_DDHRESULT( 590 )
  5537.  
  5538. /*
  5539.  * Operation could not be carried out because there is no mip-map
  5540.  * texture mapping hardware present or available.
  5541.  */
  5542. #define DDERR_NOMIPMAPHW                        MAKE_DDHRESULT( 591 )
  5543.  
  5544. /*
  5545.  * The requested action could not be performed because the surface was of
  5546.  * the wrong type.
  5547.  */
  5548. #define DDERR_INVALIDSURFACETYPE                MAKE_DDHRESULT( 592 )
  5549.  
  5550.  
  5551. /*
  5552.  * Device does not support optimized surfaces, therefore no video memory optimized surfaces
  5553.  */
  5554. #define DDERR_NOOPTIMIZEHW                      MAKE_DDHRESULT( 600 )
  5555.  
  5556. /*
  5557.  * Surface is an optimized surface, but has not yet been allocated any memory
  5558.  */
  5559. #define DDERR_NOTLOADED                         MAKE_DDHRESULT( 601 )
  5560.  
  5561. /*
  5562.  * Attempt was made to create or set a device window without first setting
  5563.  * the focus window
  5564.  */
  5565. #define DDERR_NOFOCUSWINDOW                     MAKE_DDHRESULT( 602 )
  5566.  
  5567. /*
  5568.  * Attempt was made to set a palette on a mipmap sublevel
  5569.  */
  5570. #define DDERR_NOTONMIPMAPSUBLEVEL               MAKE_DDHRESULT( 603 )
  5571.  
  5572. /*
  5573.  * A DC has already been returned for this surface. Only one DC can be
  5574.  * retrieved per surface.
  5575.  */
  5576. #define DDERR_DCALREADYCREATED                  MAKE_DDHRESULT( 620 )
  5577.  
  5578. /*
  5579.  * An attempt was made to allocate non-local video memory from a device
  5580.  * that does not support non-local video memory.
  5581.  */
  5582. #define DDERR_NONONLOCALVIDMEM                  MAKE_DDHRESULT( 630 )
  5583.  
  5584. /*
  5585.  * The attempt to page lock a surface failed.
  5586.  */
  5587. #define DDERR_CANTPAGELOCK                      MAKE_DDHRESULT( 640 )
  5588.  
  5589.  
  5590. /*
  5591.  * The attempt to page unlock a surface failed.
  5592.  */
  5593. #define DDERR_CANTPAGEUNLOCK                    MAKE_DDHRESULT( 660 )
  5594.  
  5595. /*
  5596.  * An attempt was made to page unlock a surface with no outstanding page locks.
  5597.  */
  5598. #define DDERR_NOTPAGELOCKED                     MAKE_DDHRESULT( 680 )
  5599.  
  5600. /*
  5601.  * There is more data available than the specified buffer size could hold
  5602.  */
  5603. #define DDERR_MOREDATA                          MAKE_DDHRESULT( 690 )
  5604.  
  5605. /*
  5606.  * The data has expired and is therefore no longer valid.
  5607.  */
  5608. #define DDERR_EXPIRED                           MAKE_DDHRESULT( 691 )
  5609.  
  5610. /*
  5611.  * The mode test has finished executing.
  5612.  */
  5613. #define DDERR_TESTFINISHED                      MAKE_DDHRESULT( 692 )
  5614.  
  5615. /*
  5616.  * The mode test has switched to a new mode.
  5617.  */
  5618. #define DDERR_NEWMODE                           MAKE_DDHRESULT( 693 )
  5619.  
  5620. /*
  5621.  * D3D has not yet been initialized.
  5622.  */
  5623. #define DDERR_D3DNOTINITIALIZED                 MAKE_DDHRESULT( 694 )
  5624.  
  5625. /*
  5626.  * The video port is not active
  5627.  */
  5628. #define DDERR_VIDEONOTACTIVE                    MAKE_DDHRESULT( 695 )
  5629.  
  5630. /*
  5631.  * The monitor does not have EDID data.
  5632.  */
  5633. #define DDERR_NOMONITORINFORMATION              MAKE_DDHRESULT( 696 )
  5634.  
  5635. /*
  5636.  * The driver does not enumerate display mode refresh rates.
  5637.  */
  5638. #define DDERR_NODRIVERSUPPORT                   MAKE_DDHRESULT( 697 )
  5639.  
  5640. /*
  5641.  * Surfaces created by one direct draw device cannot be used directly by
  5642.  * another direct draw device.
  5643.  */
  5644. #define DDERR_DEVICEDOESNTOWNSURFACE            MAKE_DDHRESULT( 699 )
  5645.  
  5646.  
  5647.  
  5648. /*
  5649.  * An attempt was made to invoke an interface member of a DirectDraw object
  5650.  * created by CoCreateInstance() before it was initialized.
  5651.  */
  5652. #define DDERR_NOTINITIALIZED                    CO_E_NOTINITIALIZED
  5653.  
  5654.  
  5655. /* Alpha bit depth constants */
  5656.  
  5657.  
  5658. #ifdef __cplusplus
  5659. };
  5660. #endif
  5661.  
  5662. #ifdef ENABLE_NAMELESS_UNION_PRAGMA
  5663. #pragma warning(default:4201)
  5664. #endif
  5665.  
  5666. #endif //__DDRAW_INCLUDED__
  5667.  
  5668.  
  5669.