Use angle brackets (<>) rather than quotes ("") for the include
[wine] / include / ddraw.h
1 /*
2  * Copyright (C) the Wine project
3  *
4  * This library is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * This library is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with this library; if not, write to the Free Software
16  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
17  */
18
19 #ifndef __WINE_DDRAW_H
20 #define __WINE_DDRAW_H
21
22 #include <windef.h> /* LARGE_INTEGER ... */
23 #include <wingdi.h> /* PALETTE stuff ... */
24 #include <objbase.h>
25
26 #ifdef __cplusplus
27 extern "C" {
28 #endif /* defined(__cplusplus) */
29
30 #ifndef DIRECTDRAW_VERSION
31 #define DIRECTDRAW_VERSION      0x0700
32 #endif /* DIRECTDRAW_VERSION */
33
34 /*****************************************************************************
35  * Predeclare the interfaces
36  */
37 DEFINE_GUID( CLSID_DirectDraw,          0xD7B70EE0,0x4340,0x11CF,0xB0,0x63,0x00,0x20,0xAF,0xC2,0xCD,0x35 );
38 DEFINE_GUID( CLSID_DirectDraw7,         0x3C305196,0x50DB,0x11D3,0x9C,0xFE,0x00,0xC0,0x4F,0xD9,0x30,0xC5 );
39 DEFINE_GUID( CLSID_DirectDrawClipper,   0x593817A0,0x7DB3,0x11CF,0xA2,0xDE,0x00,0xAA,0x00,0xb9,0x33,0x56 );
40 DEFINE_GUID( IID_IDirectDraw,           0x6C14DB80,0xA733,0x11CE,0xA5,0x21,0x00,0x20,0xAF,0x0B,0xE5,0x60 );
41 DEFINE_GUID( IID_IDirectDraw2,          0xB3A6F3E0,0x2B43,0x11CF,0xA2,0xDE,0x00,0xAA,0x00,0xB9,0x33,0x56 );
42 DEFINE_GUID( IID_IDirectDraw4,          0x9c59509a,0x39bd,0x11d1,0x8c,0x4a,0x00,0xc0,0x4f,0xd9,0x30,0xc5 );
43 DEFINE_GUID( IID_IDirectDraw7,          0x15e65ec0,0x3b9c,0x11d2,0xb9,0x2f,0x00,0x60,0x97,0x97,0xea,0x5b );
44 DEFINE_GUID( IID_IDirectDrawSurface,    0x6C14DB81,0xA733,0x11CE,0xA5,0x21,0x00,0x20,0xAF,0x0B,0xE5,0x60 );
45 DEFINE_GUID( IID_IDirectDrawSurface2,   0x57805885,0x6eec,0x11cf,0x94,0x41,0xa8,0x23,0x03,0xc1,0x0e,0x27 );
46 DEFINE_GUID( IID_IDirectDrawSurface3,   0xDA044E00,0x69B2,0x11D0,0xA1,0xD5,0x00,0xAA,0x00,0xB8,0xDF,0xBB );
47 DEFINE_GUID( IID_IDirectDrawSurface4,   0x0B2B8630,0xAD35,0x11D0,0x8E,0xA6,0x00,0x60,0x97,0x97,0xEA,0x5B );
48 DEFINE_GUID( IID_IDirectDrawSurface7,   0x06675a80,0x3b9b,0x11d2,0xb9,0x2f,0x00,0x60,0x97,0x97,0xea,0x5b );
49 DEFINE_GUID( IID_IDirectDrawPalette,    0x6C14DB84,0xA733,0x11CE,0xA5,0x21,0x00,0x20,0xAF,0x0B,0xE5,0x60 );
50 DEFINE_GUID( IID_IDirectDrawClipper,    0x6C14DB85,0xA733,0x11CE,0xA5,0x21,0x00,0x20,0xAF,0x0B,0xE5,0x60 );
51 DEFINE_GUID( IID_IDirectDrawColorControl,0x4B9F0EE0,0x0D7E,0x11D0,0x9B,0x06,0x00,0xA0,0xC9,0x03,0xA3,0xB8 );
52 DEFINE_GUID( IID_IDirectDrawGammaControl,0x69C11C3E,0xB46B,0x11D1,0xAD,0x7A,0x00,0xC0,0x4F,0xC2,0x9B,0x4E );
53
54 typedef struct IDirectDraw IDirectDraw,*LPDIRECTDRAW;
55 typedef struct IDirectDraw2 IDirectDraw2,*LPDIRECTDRAW2;
56 typedef struct IDirectDraw4 IDirectDraw4,*LPDIRECTDRAW4;
57 typedef struct IDirectDraw7 IDirectDraw7,*LPDIRECTDRAW7;
58 typedef struct IDirectDrawClipper IDirectDrawClipper,*LPDIRECTDRAWCLIPPER;
59 typedef struct IDirectDrawPalette IDirectDrawPalette,*LPDIRECTDRAWPALETTE;
60 typedef struct IDirectDrawSurface IDirectDrawSurface,*LPDIRECTDRAWSURFACE;
61 typedef struct IDirectDrawSurface2 IDirectDrawSurface2,*LPDIRECTDRAWSURFACE2;
62 typedef struct IDirectDrawSurface3 IDirectDrawSurface3,*LPDIRECTDRAWSURFACE3;
63 typedef struct IDirectDrawSurface4 IDirectDrawSurface4,*LPDIRECTDRAWSURFACE4;
64 typedef struct IDirectDrawSurface7 IDirectDrawSurface7,*LPDIRECTDRAWSURFACE7;
65 typedef struct IDirectDrawColorControl IDirectDrawColorControl,*LPDIRECTDRAWCOLORCONTROL;
66 typedef struct IDirectDrawGammaControl IDirectDrawGammaControl,*LPDIRECTDRAWGAMMACONTROL;
67
68
69 #define DDENUMRET_CANCEL        0
70 #define DDENUMRET_OK            1
71
72 #define DD_OK                   0
73
74
75 #define _FACDD          0x876
76 #define MAKE_DDHRESULT( code )  MAKE_HRESULT( 1, _FACDD, code )
77
78 #define DDERR_ALREADYINITIALIZED                MAKE_DDHRESULT( 5 )
79 #define DDERR_CANNOTATTACHSURFACE               MAKE_DDHRESULT( 10 )
80 #define DDERR_CANNOTDETACHSURFACE               MAKE_DDHRESULT( 20 )
81 #define DDERR_CURRENTLYNOTAVAIL                 MAKE_DDHRESULT( 40 )
82 #define DDERR_EXCEPTION                         MAKE_DDHRESULT( 55 )
83 #define DDERR_GENERIC                           E_FAIL
84 #define DDERR_HEIGHTALIGN                       MAKE_DDHRESULT( 90 )
85 #define DDERR_INCOMPATIBLEPRIMARY               MAKE_DDHRESULT( 95 )
86 #define DDERR_INVALIDCAPS                       MAKE_DDHRESULT( 100 )
87 #define DDERR_INVALIDCLIPLIST                   MAKE_DDHRESULT( 110 )
88 #define DDERR_INVALIDMODE                       MAKE_DDHRESULT( 120 )
89 #define DDERR_INVALIDOBJECT                     MAKE_DDHRESULT( 130 )
90 #define DDERR_INVALIDPARAMS                     E_INVALIDARG
91 #define DDERR_INVALIDPIXELFORMAT                MAKE_DDHRESULT( 145 )
92 #define DDERR_INVALIDRECT                       MAKE_DDHRESULT( 150 )
93 #define DDERR_LOCKEDSURFACES                    MAKE_DDHRESULT( 160 )
94 #define DDERR_NO3D                              MAKE_DDHRESULT( 170 )
95 #define DDERR_NOALPHAHW                         MAKE_DDHRESULT( 180 )
96 #define DDERR_NOSTEREOHARDWARE                  MAKE_DDHRESULT( 181 )
97 #define DDERR_NOSURFACELEFT                     MAKE_DDHRESULT( 182 )
98 #define DDERR_NOCLIPLIST                        MAKE_DDHRESULT( 205 )
99 #define DDERR_NOCOLORCONVHW                     MAKE_DDHRESULT( 210 )
100 #define DDERR_NOCOOPERATIVELEVELSET             MAKE_DDHRESULT( 212 )
101 #define DDERR_NOCOLORKEY                        MAKE_DDHRESULT( 215 )
102 #define DDERR_NOCOLORKEYHW                      MAKE_DDHRESULT( 220 )
103 #define DDERR_NODIRECTDRAWSUPPORT               MAKE_DDHRESULT( 222 )
104 #define DDERR_NOEXCLUSIVEMODE                   MAKE_DDHRESULT( 225 )
105 #define DDERR_NOFLIPHW                          MAKE_DDHRESULT( 230 )
106 #define DDERR_NOGDI                             MAKE_DDHRESULT( 240 )
107 #define DDERR_NOMIRRORHW                        MAKE_DDHRESULT( 250 )
108 #define DDERR_NOTFOUND                          MAKE_DDHRESULT( 255 )
109 #define DDERR_NOOVERLAYHW                       MAKE_DDHRESULT( 260 )
110 #define DDERR_OVERLAPPINGRECTS                  MAKE_DDHRESULT( 270 )
111 #define DDERR_NORASTEROPHW                      MAKE_DDHRESULT( 280 )
112 #define DDERR_NOROTATIONHW                      MAKE_DDHRESULT( 290 )
113 #define DDERR_NOSTRETCHHW                       MAKE_DDHRESULT( 310 )
114 #define DDERR_NOT4BITCOLOR                      MAKE_DDHRESULT( 316 )
115 #define DDERR_NOT4BITCOLORINDEX                 MAKE_DDHRESULT( 317 )
116 #define DDERR_NOT8BITCOLOR                      MAKE_DDHRESULT( 320 )
117 #define DDERR_NOTEXTUREHW                       MAKE_DDHRESULT( 330 )
118 #define DDERR_NOVSYNCHW                         MAKE_DDHRESULT( 335 )
119 #define DDERR_NOZBUFFERHW                       MAKE_DDHRESULT( 340 )
120 #define DDERR_NOZOVERLAYHW                      MAKE_DDHRESULT( 350 )
121 #define DDERR_OUTOFCAPS                         MAKE_DDHRESULT( 360 )
122 #define DDERR_OUTOFMEMORY                       E_OUTOFMEMORY
123 #define DDERR_OUTOFVIDEOMEMORY                  MAKE_DDHRESULT( 380 )
124 #define DDERR_OVERLAYCANTCLIP                   MAKE_DDHRESULT( 382 )
125 #define DDERR_OVERLAYCOLORKEYONLYONEACTIVE      MAKE_DDHRESULT( 384 )
126 #define DDERR_PALETTEBUSY                       MAKE_DDHRESULT( 387 )
127 #define DDERR_COLORKEYNOTSET                    MAKE_DDHRESULT( 400 )
128 #define DDERR_SURFACEALREADYATTACHED            MAKE_DDHRESULT( 410 )
129 #define DDERR_SURFACEALREADYDEPENDENT           MAKE_DDHRESULT( 420 )
130 #define DDERR_SURFACEBUSY                       MAKE_DDHRESULT( 430 )
131 #define DDERR_CANTLOCKSURFACE                   MAKE_DDHRESULT( 435 )
132 #define DDERR_SURFACEISOBSCURED                 MAKE_DDHRESULT( 440 )
133 #define DDERR_SURFACELOST                       MAKE_DDHRESULT( 450 )
134 #define DDERR_SURFACENOTATTACHED                MAKE_DDHRESULT( 460 )
135 #define DDERR_TOOBIGHEIGHT                      MAKE_DDHRESULT( 470 )
136 #define DDERR_TOOBIGSIZE                        MAKE_DDHRESULT( 480 )
137 #define DDERR_TOOBIGWIDTH                       MAKE_DDHRESULT( 490 )
138 #define DDERR_UNSUPPORTED                       E_NOTIMPL
139 #define DDERR_UNSUPPORTEDFORMAT                 MAKE_DDHRESULT( 510 )
140 #define DDERR_UNSUPPORTEDMASK                   MAKE_DDHRESULT( 520 )
141 #define DDERR_INVALIDSTREAM                     MAKE_DDHRESULT( 521 )
142 #define DDERR_VERTICALBLANKINPROGRESS           MAKE_DDHRESULT( 537 )
143 #define DDERR_WASSTILLDRAWING                   MAKE_DDHRESULT( 540 )
144 #define DDERR_DDSCAPSCOMPLEXREQUIRED            MAKE_DDHRESULT( 542 )
145 #define DDERR_XALIGN                            MAKE_DDHRESULT( 560 )
146 #define DDERR_INVALIDDIRECTDRAWGUID             MAKE_DDHRESULT( 561 )
147 #define DDERR_DIRECTDRAWALREADYCREATED          MAKE_DDHRESULT( 562 )
148 #define DDERR_NODIRECTDRAWHW                    MAKE_DDHRESULT( 563 )
149 #define DDERR_PRIMARYSURFACEALREADYEXISTS       MAKE_DDHRESULT( 564 )
150 #define DDERR_NOEMULATION                       MAKE_DDHRESULT( 565 )
151 #define DDERR_REGIONTOOSMALL                    MAKE_DDHRESULT( 566 )
152 #define DDERR_CLIPPERISUSINGHWND                MAKE_DDHRESULT( 567 )
153 #define DDERR_NOCLIPPERATTACHED                 MAKE_DDHRESULT( 568 )
154 #define DDERR_NOHWND                            MAKE_DDHRESULT( 569 )
155 #define DDERR_HWNDSUBCLASSED                    MAKE_DDHRESULT( 570 )
156 #define DDERR_HWNDALREADYSET                    MAKE_DDHRESULT( 571 )
157 #define DDERR_NOPALETTEATTACHED                 MAKE_DDHRESULT( 572 )
158 #define DDERR_NOPALETTEHW                       MAKE_DDHRESULT( 573 )
159 #define DDERR_BLTFASTCANTCLIP                   MAKE_DDHRESULT( 574 )
160 #define DDERR_NOBLTHW                           MAKE_DDHRESULT( 575 )
161 #define DDERR_NODDROPSHW                        MAKE_DDHRESULT( 576 )
162 #define DDERR_OVERLAYNOTVISIBLE                 MAKE_DDHRESULT( 577 )
163 #define DDERR_NOOVERLAYDEST                     MAKE_DDHRESULT( 578 )
164 #define DDERR_INVALIDPOSITION                   MAKE_DDHRESULT( 579 )
165 #define DDERR_NOTAOVERLAYSURFACE                MAKE_DDHRESULT( 580 )
166 #define DDERR_EXCLUSIVEMODEALREADYSET           MAKE_DDHRESULT( 581 )
167 #define DDERR_NOTFLIPPABLE                      MAKE_DDHRESULT( 582 )
168 #define DDERR_CANTDUPLICATE                     MAKE_DDHRESULT( 583 )
169 #define DDERR_NOTLOCKED                         MAKE_DDHRESULT( 584 )
170 #define DDERR_CANTCREATEDC                      MAKE_DDHRESULT( 585 )
171 #define DDERR_NODC                              MAKE_DDHRESULT( 586 )
172 #define DDERR_WRONGMODE                         MAKE_DDHRESULT( 587 )
173 #define DDERR_IMPLICITLYCREATED                 MAKE_DDHRESULT( 588 )
174 #define DDERR_NOTPALETTIZED                     MAKE_DDHRESULT( 589 )
175 #define DDERR_UNSUPPORTEDMODE                   MAKE_DDHRESULT( 590 )
176 #define DDERR_NOMIPMAPHW                        MAKE_DDHRESULT( 591 )
177 #define DDERR_INVALIDSURFACETYPE                MAKE_DDHRESULT( 592 )
178 #define DDERR_NOOPTIMIZEHW                      MAKE_DDHRESULT( 600 )
179 #define DDERR_NOTLOADED                         MAKE_DDHRESULT( 601 )
180 #define DDERR_NOFOCUSWINDOW                     MAKE_DDHRESULT( 602 )
181 #define DDERR_NOTONMIPMAPSUBLEVEL               MAKE_DDHRESULT( 603 )
182 #define DDERR_DCALREADYCREATED                  MAKE_DDHRESULT( 620 )
183 #define DDERR_NONONLOCALVIDMEM                  MAKE_DDHRESULT( 630 )
184 #define DDERR_CANTPAGELOCK                      MAKE_DDHRESULT( 640 )
185 #define DDERR_CANTPAGEUNLOCK                    MAKE_DDHRESULT( 660 )
186 #define DDERR_NOTPAGELOCKED                     MAKE_DDHRESULT( 680 )
187 #define DDERR_MOREDATA                          MAKE_DDHRESULT( 690 )
188 #define DDERR_EXPIRED                           MAKE_DDHRESULT( 691 )
189 #define DDERR_TESTFINISHED                      MAKE_DDHRESULT( 692 )
190 #define DDERR_NEWMODE                           MAKE_DDHRESULT( 693 )
191 #define DDERR_D3DNOTINITIALIZED                 MAKE_DDHRESULT( 694 )
192 #define DDERR_VIDEONOTACTIVE                    MAKE_DDHRESULT( 695 )
193 #define DDERR_NOMONITORINFORMATION              MAKE_DDHRESULT( 696 )
194 #define DDERR_NODRIVERSUPPORT                   MAKE_DDHRESULT( 697 )
195 #define DDERR_DEVICEDOESNTOWNSURFACE            MAKE_DDHRESULT( 699 )
196 #define DDERR_NOTINITIALIZED                    CO_E_NOTINITIALIZED
197
198 /* dwFlags for Blt* */
199 #define DDBLT_ALPHADEST                         0x00000001
200 #define DDBLT_ALPHADESTCONSTOVERRIDE            0x00000002
201 #define DDBLT_ALPHADESTNEG                      0x00000004
202 #define DDBLT_ALPHADESTSURFACEOVERRIDE          0x00000008
203 #define DDBLT_ALPHAEDGEBLEND                    0x00000010
204 #define DDBLT_ALPHASRC                          0x00000020
205 #define DDBLT_ALPHASRCCONSTOVERRIDE             0x00000040
206 #define DDBLT_ALPHASRCNEG                       0x00000080
207 #define DDBLT_ALPHASRCSURFACEOVERRIDE           0x00000100
208 #define DDBLT_ASYNC                             0x00000200
209 #define DDBLT_COLORFILL                         0x00000400
210 #define DDBLT_DDFX                              0x00000800
211 #define DDBLT_DDROPS                            0x00001000
212 #define DDBLT_KEYDEST                           0x00002000
213 #define DDBLT_KEYDESTOVERRIDE                   0x00004000
214 #define DDBLT_KEYSRC                            0x00008000
215 #define DDBLT_KEYSRCOVERRIDE                    0x00010000
216 #define DDBLT_ROP                               0x00020000
217 #define DDBLT_ROTATIONANGLE                     0x00040000
218 #define DDBLT_ZBUFFER                           0x00080000
219 #define DDBLT_ZBUFFERDESTCONSTOVERRIDE          0x00100000
220 #define DDBLT_ZBUFFERDESTOVERRIDE               0x00200000
221 #define DDBLT_ZBUFFERSRCCONSTOVERRIDE           0x00400000
222 #define DDBLT_ZBUFFERSRCOVERRIDE                0x00800000
223 #define DDBLT_WAIT                              0x01000000
224 #define DDBLT_DEPTHFILL                         0x02000000
225 #define DDBLT_DONOTWAIT                         0x08000000
226
227 /* dwTrans for BltFast */
228 #define DDBLTFAST_NOCOLORKEY                    0x00000000
229 #define DDBLTFAST_SRCCOLORKEY                   0x00000001
230 #define DDBLTFAST_DESTCOLORKEY                  0x00000002
231 #define DDBLTFAST_WAIT                          0x00000010
232 #define DDBLTFAST_DONOTWAIT                     0x00000020
233
234 /* dwFlags for Flip */
235 #define DDFLIP_WAIT             0x00000001
236 #define DDFLIP_EVEN             0x00000002 /* only valid for overlay */
237 #define DDFLIP_ODD              0x00000004 /* only valid for overlay */
238 #define DDFLIP_NOVSYNC          0x00000008
239 #define DDFLIP_STEREO           0x00000010
240 #define DDFLIP_DONOTWAIT        0x00000020
241
242 /* dwFlags for GetBltStatus */
243 #define DDGBS_CANBLT                            0x00000001
244 #define DDGBS_ISBLTDONE                         0x00000002
245
246 /* dwFlags for IDirectDrawSurface7::GetFlipStatus */
247 #define DDGFS_CANFLIP           1L
248 #define DDGFS_ISFLIPDONE        2L
249
250 /* dwFlags for IDirectDrawSurface7::SetPrivateData */
251 #define DDSPD_IUNKNOWNPTR       1L
252 #define DDSPD_VOLATILE          2L
253
254 /* DDSCAPS.dwCaps */
255 /* reserved1, was 3d capable */
256 #define DDSCAPS_RESERVED1               0x00000001
257 /* surface contains alpha information */
258 #define DDSCAPS_ALPHA                   0x00000002
259 /* this surface is a backbuffer */
260 #define DDSCAPS_BACKBUFFER              0x00000004
261 /* complex surface structure */
262 #define DDSCAPS_COMPLEX                 0x00000008
263 /* part of surface flipping structure */
264 #define DDSCAPS_FLIP                    0x00000010
265 /* this surface is the frontbuffer surface */
266 #define DDSCAPS_FRONTBUFFER             0x00000020
267 /* this is a plain offscreen surface */
268 #define DDSCAPS_OFFSCREENPLAIN          0x00000040
269 /* overlay */
270 #define DDSCAPS_OVERLAY                 0x00000080
271 /* palette objects can be created and attached to us */
272 #define DDSCAPS_PALETTE                 0x00000100
273 /* primary surface (the one the user looks at currently)(right eye)*/
274 #define DDSCAPS_PRIMARYSURFACE          0x00000200
275 /* primary surface for left eye */
276 #define DDSCAPS_PRIMARYSURFACELEFT      0x00000400
277 /* surface exists in systemmemory */
278 #define DDSCAPS_SYSTEMMEMORY            0x00000800
279 /* surface can be used as a texture */
280 #define DDSCAPS_TEXTURE                 0x00001000
281 /* surface may be destination for 3d rendering */
282 #define DDSCAPS_3DDEVICE                0x00002000
283 /* surface exists in videomemory */
284 #define DDSCAPS_VIDEOMEMORY             0x00004000
285 /* surface changes immediately visible */
286 #define DDSCAPS_VISIBLE                 0x00008000
287 /* write only surface */
288 #define DDSCAPS_WRITEONLY               0x00010000
289 /* zbuffer surface */
290 #define DDSCAPS_ZBUFFER                 0x00020000
291 /* has its own DC */
292 #define DDSCAPS_OWNDC                   0x00040000
293 /* surface should be able to receive live video */
294 #define DDSCAPS_LIVEVIDEO               0x00080000
295 /* should be able to have a hw codec decompress stuff into it */
296 #define DDSCAPS_HWCODEC                 0x00100000
297 /* mode X (320x200 or 320x240) surface */
298 #define DDSCAPS_MODEX                   0x00200000
299 /* one mipmap surface (1 level) */
300 #define DDSCAPS_MIPMAP                  0x00400000
301 #define DDSCAPS_RESERVED2               0x00800000
302 /* memory allocation delayed until Load() */
303 #define DDSCAPS_ALLOCONLOAD             0x04000000
304 /* Indicates that the surface will receive data from a video port */
305 #define DDSCAPS_VIDEOPORT               0x08000000
306 /* surface is in local videomemory */
307 #define DDSCAPS_LOCALVIDMEM             0x10000000
308 /* surface is in nonlocal videomemory */
309 #define DDSCAPS_NONLOCALVIDMEM          0x20000000
310 /* surface is a standard VGA mode surface (NOT ModeX) */
311 #define DDSCAPS_STANDARDVGAMODE         0x40000000
312 /* optimized? surface */
313 #define DDSCAPS_OPTIMIZED               0x80000000
314
315 typedef struct _DDSCAPS {
316         DWORD   dwCaps; /* capabilities of surface wanted */
317 } DDSCAPS,*LPDDSCAPS;
318
319 /* DDSCAPS2.dwCaps2 */
320 /* indicates the surface will receive data from a video port using
321    deinterlacing hardware. */
322 #define DDSCAPS2_HARDWAREDEINTERLACE    0x00000002
323 /* indicates the surface will be locked very frequently. */
324 #define DDSCAPS2_HINTDYNAMIC            0x00000004
325 /* indicates surface can be re-ordered or retiled on load() */
326 #define DDSCAPS2_HINTSTATIC             0x00000008
327 /* indicates surface to be managed by directdraw/direct3D */
328 #define DDSCAPS2_TEXTUREMANAGE          0x00000010
329 /* reserved bits */
330 #define DDSCAPS2_RESERVED1              0x00000020
331 #define DDSCAPS2_RESERVED2              0x00000040
332 /* indicates surface will never be locked again */
333 #define DDSCAPS2_OPAQUE                 0x00000080
334 /* set at CreateSurface() time to indicate antialising will be used */
335 #define DDSCAPS2_HINTANTIALIASING       0x00000100
336 /* set at CreateSurface() time to indicate cubic environment map */
337 #define DDSCAPS2_CUBEMAP                0x00000200
338 /* face flags for cube maps */
339 #define DDSCAPS2_CUBEMAP_POSITIVEX      0x00000400
340 #define DDSCAPS2_CUBEMAP_NEGATIVEX      0x00000800
341 #define DDSCAPS2_CUBEMAP_POSITIVEY      0x00001000
342 #define DDSCAPS2_CUBEMAP_NEGATIVEY      0x00002000
343 #define DDSCAPS2_CUBEMAP_POSITIVEZ      0x00004000
344 #define DDSCAPS2_CUBEMAP_NEGATIVEZ      0x00008000
345 /* specifies all faces of a cube for CreateSurface() */
346 #define DDSCAPS2_CUBEMAP_ALLFACES ( DDSCAPS2_CUBEMAP_POSITIVEX |\
347                                     DDSCAPS2_CUBEMAP_NEGATIVEX |\
348                                     DDSCAPS2_CUBEMAP_POSITIVEY |\
349                                     DDSCAPS2_CUBEMAP_NEGATIVEY |\
350                                     DDSCAPS2_CUBEMAP_POSITIVEZ |\
351                                     DDSCAPS2_CUBEMAP_NEGATIVEZ )
352 /* set for mipmap sublevels on DirectX7 and later.  ignored by CreateSurface() */
353 #define DDSCAPS2_MIPMAPSUBLEVEL         0x00010000
354 /* indicates texture surface to be managed by Direct3D *only* */
355 #define DDSCAPS2_D3DTEXTUREMANAGE       0x00020000
356 /* indicates managed surface that can safely be lost */
357 #define DDSCAPS2_DONOTPERSIST           0x00040000
358 /* indicates surface is part of a stereo flipping chain */
359 #define DDSCAPS2_STEREOSURFACELEFT      0x00080000
360
361 typedef struct _DDSCAPS2 {
362         DWORD   dwCaps; /* capabilities of surface wanted */
363         DWORD   dwCaps2; /* additional capabilities */
364         DWORD   dwCaps3; /* reserved capabilities */
365         DWORD   dwCaps4; /* more reserved capabilities */
366 } DDSCAPS2,*LPDDSCAPS2;
367
368 #define DD_ROP_SPACE    (256/32)        /* space required to store ROP array */
369
370 typedef struct _DDCAPS_DX7              /* DirectX 7 version of caps struct */
371 {
372     DWORD       dwSize;                 /* size of the DDDRIVERCAPS structure */
373     DWORD       dwCaps;                 /* driver specific capabilities */
374     DWORD       dwCaps2;                /* more driver specific capabilites */
375     DWORD       dwCKeyCaps;             /* color key capabilities of the surface */
376     DWORD       dwFXCaps;               /* driver specific stretching and effects capabilites */
377     DWORD       dwFXAlphaCaps;          /* alpha driver specific capabilities */
378     DWORD       dwPalCaps;              /* palette capabilities */
379     DWORD       dwSVCaps;               /* stereo vision capabilities */
380     DWORD       dwAlphaBltConstBitDepths;       /* DDBD_2,4,8 */
381     DWORD       dwAlphaBltPixelBitDepths;       /* DDBD_1,2,4,8 */
382     DWORD       dwAlphaBltSurfaceBitDepths;     /* DDBD_1,2,4,8 */
383     DWORD       dwAlphaOverlayConstBitDepths;   /* DDBD_2,4,8 */
384     DWORD       dwAlphaOverlayPixelBitDepths;   /* DDBD_1,2,4,8 */
385     DWORD       dwAlphaOverlaySurfaceBitDepths; /* DDBD_1,2,4,8 */
386     DWORD       dwZBufferBitDepths;             /* DDBD_8,16,24,32 */
387     DWORD       dwVidMemTotal;          /* total amount of video memory */
388     DWORD       dwVidMemFree;           /* amount of free video memory */
389     DWORD       dwMaxVisibleOverlays;   /* maximum number of visible overlays */
390     DWORD       dwCurrVisibleOverlays;  /* current number of visible overlays */
391     DWORD       dwNumFourCCCodes;       /* number of four cc codes */
392     DWORD       dwAlignBoundarySrc;     /* source rectangle alignment */
393     DWORD       dwAlignSizeSrc;         /* source rectangle byte size */
394     DWORD       dwAlignBoundaryDest;    /* dest rectangle alignment */
395     DWORD       dwAlignSizeDest;        /* dest rectangle byte size */
396     DWORD       dwAlignStrideAlign;     /* stride alignment */
397     DWORD       dwRops[DD_ROP_SPACE];   /* ROPS supported */
398     DDSCAPS     ddsOldCaps;             /* old DDSCAPS - superseded for DirectX6+ */
399     DWORD       dwMinOverlayStretch;    /* minimum overlay stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3 */
400     DWORD       dwMaxOverlayStretch;    /* maximum overlay stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3 */
401     DWORD       dwMinLiveVideoStretch;  /* minimum live video stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3 */
402     DWORD       dwMaxLiveVideoStretch;  /* maximum live video stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3 */
403     DWORD       dwMinHwCodecStretch;    /* minimum hardware codec stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3 */
404     DWORD       dwMaxHwCodecStretch;    /* maximum hardware codec stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3 */
405     DWORD       dwReserved1;
406     DWORD       dwReserved2;
407     DWORD       dwReserved3;
408     DWORD       dwSVBCaps;              /* driver specific capabilities for System->Vmem blts */
409     DWORD       dwSVBCKeyCaps;          /* driver color key capabilities for System->Vmem blts */
410     DWORD       dwSVBFXCaps;            /* driver FX capabilities for System->Vmem blts */
411     DWORD       dwSVBRops[DD_ROP_SPACE];/* ROPS supported for System->Vmem blts */
412     DWORD       dwVSBCaps;              /* driver specific capabilities for Vmem->System blts */
413     DWORD       dwVSBCKeyCaps;          /* driver color key capabilities for Vmem->System blts */
414     DWORD       dwVSBFXCaps;            /* driver FX capabilities for Vmem->System blts */
415     DWORD       dwVSBRops[DD_ROP_SPACE];/* ROPS supported for Vmem->System blts */
416     DWORD       dwSSBCaps;              /* driver specific capabilities for System->System blts */
417     DWORD       dwSSBCKeyCaps;          /* driver color key capabilities for System->System blts */
418     DWORD       dwSSBFXCaps;            /* driver FX capabilities for System->System blts */
419     DWORD       dwSSBRops[DD_ROP_SPACE];/* ROPS supported for System->System blts */
420     DWORD       dwMaxVideoPorts;        /* maximum number of usable video ports */
421     DWORD       dwCurrVideoPorts;       /* current number of video ports used */
422     DWORD       dwSVBCaps2;             /* more driver specific capabilities for System->Vmem blts */
423     DWORD       dwNLVBCaps;             /* driver specific capabilities for non-local->local vidmem blts */
424     DWORD       dwNLVBCaps2;            /* more driver specific capabilities non-local->local vidmem blts */
425     DWORD       dwNLVBCKeyCaps;         /* driver color key capabilities for non-local->local vidmem blts */
426     DWORD       dwNLVBFXCaps;           /* driver FX capabilities for non-local->local blts */
427     DWORD       dwNLVBRops[DD_ROP_SPACE]; /* ROPS supported for non-local->local blts */
428     DDSCAPS2    ddsCaps;                /* surface capabilities */
429 } DDCAPS_DX7,*LPDDCAPS_DX7;
430
431 typedef struct _DDCAPS_DX6              /* DirectX 6 version of caps struct */
432 {
433     DWORD       dwSize;                 /* size of the DDDRIVERCAPS structure */
434     DWORD       dwCaps;                 /* driver specific capabilities */
435     DWORD       dwCaps2;                /* more driver specific capabilites */
436     DWORD       dwCKeyCaps;             /* color key capabilities of the surface */
437     DWORD       dwFXCaps;               /* driver specific stretching and effects capabilites */
438     DWORD       dwFXAlphaCaps;          /* alpha driver specific capabilities */
439     DWORD       dwPalCaps;              /* palette capabilities */
440     DWORD       dwSVCaps;               /* stereo vision capabilities */
441     DWORD       dwAlphaBltConstBitDepths;       /* DDBD_2,4,8 */
442     DWORD       dwAlphaBltPixelBitDepths;       /* DDBD_1,2,4,8 */
443     DWORD       dwAlphaBltSurfaceBitDepths;     /* DDBD_1,2,4,8 */
444     DWORD       dwAlphaOverlayConstBitDepths;   /* DDBD_2,4,8 */
445     DWORD       dwAlphaOverlayPixelBitDepths;   /* DDBD_1,2,4,8 */
446     DWORD       dwAlphaOverlaySurfaceBitDepths; /* DDBD_1,2,4,8 */
447     DWORD       dwZBufferBitDepths;             /* DDBD_8,16,24,32 */
448     DWORD       dwVidMemTotal;          /* total amount of video memory */
449     DWORD       dwVidMemFree;           /* amount of free video memory */
450     DWORD       dwMaxVisibleOverlays;   /* maximum number of visible overlays */
451     DWORD       dwCurrVisibleOverlays;  /* current number of visible overlays */
452     DWORD       dwNumFourCCCodes;       /* number of four cc codes */
453     DWORD       dwAlignBoundarySrc;     /* source rectangle alignment */
454     DWORD       dwAlignSizeSrc;         /* source rectangle byte size */
455     DWORD       dwAlignBoundaryDest;    /* dest rectangle alignment */
456     DWORD       dwAlignSizeDest;        /* dest rectangle byte size */
457     DWORD       dwAlignStrideAlign;     /* stride alignment */
458     DWORD       dwRops[DD_ROP_SPACE];   /* ROPS supported */
459     DDSCAPS     ddsOldCaps;             /* old DDSCAPS - superseded for DirectX6+ */
460     DWORD       dwMinOverlayStretch;    /* minimum overlay stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3 */
461     DWORD       dwMaxOverlayStretch;    /* maximum overlay stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3 */
462     DWORD       dwMinLiveVideoStretch;  /* minimum live video stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3 */
463     DWORD       dwMaxLiveVideoStretch;  /* maximum live video stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3 */
464     DWORD       dwMinHwCodecStretch;    /* minimum hardware codec stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3 */
465     DWORD       dwMaxHwCodecStretch;    /* maximum hardware codec stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3 */
466     DWORD       dwReserved1;
467     DWORD       dwReserved2;
468     DWORD       dwReserved3;
469     DWORD       dwSVBCaps;              /* driver specific capabilities for System->Vmem blts */
470     DWORD       dwSVBCKeyCaps;          /* driver color key capabilities for System->Vmem blts */
471     DWORD       dwSVBFXCaps;            /* driver FX capabilities for System->Vmem blts */
472     DWORD       dwSVBRops[DD_ROP_SPACE];/* ROPS supported for System->Vmem blts */
473     DWORD       dwVSBCaps;              /* driver specific capabilities for Vmem->System blts */
474     DWORD       dwVSBCKeyCaps;          /* driver color key capabilities for Vmem->System blts */
475     DWORD       dwVSBFXCaps;            /* driver FX capabilities for Vmem->System blts */
476     DWORD       dwVSBRops[DD_ROP_SPACE];/* ROPS supported for Vmem->System blts */
477     DWORD       dwSSBCaps;              /* driver specific capabilities for System->System blts */
478     DWORD       dwSSBCKeyCaps;          /* driver color key capabilities for System->System blts */
479     DWORD       dwSSBFXCaps;            /* driver FX capabilities for System->System blts */
480     DWORD       dwSSBRops[DD_ROP_SPACE];/* ROPS supported for System->System blts */
481     DWORD       dwMaxVideoPorts;        /* maximum number of usable video ports */
482     DWORD       dwCurrVideoPorts;       /* current number of video ports used */
483     DWORD       dwSVBCaps2;             /* more driver specific capabilities for System->Vmem blts */
484     DWORD       dwNLVBCaps;             /* driver specific capabilities for non-local->local vidmem blts */
485     DWORD       dwNLVBCaps2;            /* more driver specific capabilities non-local->local vidmem blts */
486     DWORD       dwNLVBCKeyCaps;         /* driver color key capabilities for non-local->local vidmem blts */
487     DWORD       dwNLVBFXCaps;           /* driver FX capabilities for non-local->local blts */
488     DWORD       dwNLVBRops[DD_ROP_SPACE]; /* ROPS supported for non-local->local blts */
489     /* and one new member for DirectX 6 */
490     DDSCAPS2    ddsCaps;                /* surface capabilities */
491 } DDCAPS_DX6,*LPDDCAPS_DX6;
492
493 typedef struct _DDCAPS_DX5              /* DirectX5 version of caps struct */
494 {
495     DWORD       dwSize;                 /* size of the DDDRIVERCAPS structure */
496     DWORD       dwCaps;                 /* driver specific capabilities */
497     DWORD       dwCaps2;                /* more driver specific capabilites */
498     DWORD       dwCKeyCaps;             /* color key capabilities of the surface */
499     DWORD       dwFXCaps;               /* driver specific stretching and effects capabilites */
500     DWORD       dwFXAlphaCaps;          /* alpha driver specific capabilities */
501     DWORD       dwPalCaps;              /* palette capabilities */
502     DWORD       dwSVCaps;               /* stereo vision capabilities */
503     DWORD       dwAlphaBltConstBitDepths;       /* DDBD_2,4,8 */
504     DWORD       dwAlphaBltPixelBitDepths;       /* DDBD_1,2,4,8 */
505     DWORD       dwAlphaBltSurfaceBitDepths;     /* DDBD_1,2,4,8 */
506     DWORD       dwAlphaOverlayConstBitDepths;   /* DDBD_2,4,8 */
507     DWORD       dwAlphaOverlayPixelBitDepths;   /* DDBD_1,2,4,8 */
508     DWORD       dwAlphaOverlaySurfaceBitDepths; /* DDBD_1,2,4,8 */
509     DWORD       dwZBufferBitDepths;             /* DDBD_8,16,24,32 */
510     DWORD       dwVidMemTotal;          /* total amount of video memory */
511     DWORD       dwVidMemFree;           /* amount of free video memory */
512     DWORD       dwMaxVisibleOverlays;   /* maximum number of visible overlays */
513     DWORD       dwCurrVisibleOverlays;  /* current number of visible overlays */
514     DWORD       dwNumFourCCCodes;       /* number of four cc codes */
515     DWORD       dwAlignBoundarySrc;     /* source rectangle alignment */
516     DWORD       dwAlignSizeSrc;         /* source rectangle byte size */
517     DWORD       dwAlignBoundaryDest;    /* dest rectangle alignment */
518     DWORD       dwAlignSizeDest;        /* dest rectangle byte size */
519     DWORD       dwAlignStrideAlign;     /* stride alignment */
520     DWORD       dwRops[DD_ROP_SPACE];   /* ROPS supported */
521     DDSCAPS     ddsCaps;                /* DDSCAPS structure has all the general capabilities */
522     DWORD       dwMinOverlayStretch;    /* minimum overlay stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3 */
523     DWORD       dwMaxOverlayStretch;    /* maximum overlay stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3 */
524     DWORD       dwMinLiveVideoStretch;  /* minimum live video stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3 */
525     DWORD       dwMaxLiveVideoStretch;  /* maximum live video stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3 */
526     DWORD       dwMinHwCodecStretch;    /* minimum hardware codec stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3 */
527     DWORD       dwMaxHwCodecStretch;    /* maximum hardware codec stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3 */
528     DWORD       dwReserved1;
529     DWORD       dwReserved2;
530     DWORD       dwReserved3;
531     DWORD       dwSVBCaps;              /* driver specific capabilities for System->Vmem blts */
532     DWORD       dwSVBCKeyCaps;          /* driver color key capabilities for System->Vmem blts */
533     DWORD       dwSVBFXCaps;            /* driver FX capabilities for System->Vmem blts */
534     DWORD       dwSVBRops[DD_ROP_SPACE];/* ROPS supported for System->Vmem blts */
535     DWORD       dwVSBCaps;              /* driver specific capabilities for Vmem->System blts */
536     DWORD       dwVSBCKeyCaps;          /* driver color key capabilities for Vmem->System blts */
537     DWORD       dwVSBFXCaps;            /* driver FX capabilities for Vmem->System blts */
538     DWORD       dwVSBRops[DD_ROP_SPACE];/* ROPS supported for Vmem->System blts */
539     DWORD       dwSSBCaps;              /* driver specific capabilities for System->System blts */
540     DWORD       dwSSBCKeyCaps;          /* driver color key capabilities for System->System blts */
541     DWORD       dwSSBFXCaps;            /* driver FX capabilities for System->System blts */
542     DWORD       dwSSBRops[DD_ROP_SPACE];/* ROPS supported for System->System blts */
543     /* the following are the new DirectX 5 members */
544     DWORD       dwMaxVideoPorts;        /* maximum number of usable video ports */
545     DWORD       dwCurrVideoPorts;       /* current number of video ports used */
546     DWORD       dwSVBCaps2;             /* more driver specific capabilities for System->Vmem blts */
547     DWORD       dwNLVBCaps;             /* driver specific capabilities for non-local->local vidmem blts */
548     DWORD       dwNLVBCaps2;            /* more driver specific capabilities non-local->local vidmem blts */
549     DWORD       dwNLVBCKeyCaps;         /* driver color key capabilities for non-local->local vidmem blts */
550     DWORD       dwNLVBFXCaps;           /* driver FX capabilities for non-local->local blts */
551     DWORD       dwNLVBRops[DD_ROP_SPACE]; /* ROPS supported for non-local->local blts */
552 } DDCAPS_DX5,*LPDDCAPS_DX5;
553
554 typedef struct _DDCAPS_DX3              /* DirectX3 version of caps struct */
555 {
556     DWORD       dwSize;                 /* size of the DDDRIVERCAPS structure */
557     DWORD       dwCaps;                 /* driver specific capabilities */
558     DWORD       dwCaps2;                /* more driver specific capabilites */
559     DWORD       dwCKeyCaps;             /* color key capabilities of the surface */
560     DWORD       dwFXCaps;               /* driver specific stretching and effects capabilites */
561     DWORD       dwFXAlphaCaps;          /* alpha driver specific capabilities */
562     DWORD       dwPalCaps;              /* palette capabilities */
563     DWORD       dwSVCaps;               /* stereo vision capabilities */
564     DWORD       dwAlphaBltConstBitDepths;       /* DDBD_2,4,8 */
565     DWORD       dwAlphaBltPixelBitDepths;       /* DDBD_1,2,4,8 */
566     DWORD       dwAlphaBltSurfaceBitDepths;     /* DDBD_1,2,4,8 */
567     DWORD       dwAlphaOverlayConstBitDepths;   /* DDBD_2,4,8 */
568     DWORD       dwAlphaOverlayPixelBitDepths;   /* DDBD_1,2,4,8 */
569     DWORD       dwAlphaOverlaySurfaceBitDepths; /* DDBD_1,2,4,8 */
570     DWORD       dwZBufferBitDepths;             /* DDBD_8,16,24,32 */
571     DWORD       dwVidMemTotal;          /* total amount of video memory */
572     DWORD       dwVidMemFree;           /* amount of free video memory */
573     DWORD       dwMaxVisibleOverlays;   /* maximum number of visible overlays */
574     DWORD       dwCurrVisibleOverlays;  /* current number of visible overlays */
575     DWORD       dwNumFourCCCodes;       /* number of four cc codes */
576     DWORD       dwAlignBoundarySrc;     /* source rectangle alignment */
577     DWORD       dwAlignSizeSrc;         /* source rectangle byte size */
578     DWORD       dwAlignBoundaryDest;    /* dest rectangle alignment */
579     DWORD       dwAlignSizeDest;        /* dest rectangle byte size */
580     DWORD       dwAlignStrideAlign;     /* stride alignment */
581     DWORD       dwRops[DD_ROP_SPACE];   /* ROPS supported */
582     DDSCAPS     ddsCaps;                /* DDSCAPS structure has all the general capabilities */
583     DWORD       dwMinOverlayStretch;    /* minimum overlay stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3 */
584     DWORD       dwMaxOverlayStretch;    /* maximum overlay stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3 */
585     DWORD       dwMinLiveVideoStretch;  /* minimum live video stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3 */
586     DWORD       dwMaxLiveVideoStretch;  /* maximum live video stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3 */
587     DWORD       dwMinHwCodecStretch;    /* minimum hardware codec stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3 */
588     DWORD       dwMaxHwCodecStretch;    /* maximum hardware codec stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3 */
589     DWORD       dwReserved1;
590     DWORD       dwReserved2;
591     DWORD       dwReserved3;
592     DWORD       dwSVBCaps;              /* driver specific capabilities for System->Vmem blts */
593     DWORD       dwSVBCKeyCaps;          /* driver color key capabilities for System->Vmem blts */
594     DWORD       dwSVBFXCaps;            /* driver FX capabilities for System->Vmem blts */
595     DWORD       dwSVBRops[DD_ROP_SPACE];/* ROPS supported for System->Vmem blts */
596     DWORD       dwVSBCaps;              /* driver specific capabilities for Vmem->System blts */
597     DWORD       dwVSBCKeyCaps;          /* driver color key capabilities for Vmem->System blts */
598     DWORD       dwVSBFXCaps;            /* driver FX capabilities for Vmem->System blts */
599     DWORD       dwVSBRops[DD_ROP_SPACE];/* ROPS supported for Vmem->System blts */
600     DWORD       dwSSBCaps;              /* driver specific capabilities for System->System blts */
601     DWORD       dwSSBCKeyCaps;          /* driver color key capabilities for System->System blts */
602     DWORD       dwSSBFXCaps;            /* driver FX capabilities for System->System blts */
603     DWORD       dwSSBRops[DD_ROP_SPACE];/* ROPS supported for System->System blts */
604     DWORD       dwReserved4;
605     DWORD       dwReserved5;
606     DWORD       dwReserved6;
607 } DDCAPS_DX3,*LPDDCAPS_DX3;
608
609 /* set caps struct according to DIRECTDRAW_VERSION */
610
611 #if DIRECTDRAW_VERSION <= 0x300
612 typedef DDCAPS_DX3 DDCAPS;
613 #elif DIRECTDRAW_VERSION <= 0x500
614 typedef DDCAPS_DX5 DDCAPS;
615 #elif DIRECTDRAW_VERSION <= 0x600
616 typedef DDCAPS_DX6 DDCAPS;
617 #else
618 typedef DDCAPS_DX7 DDCAPS;
619 #endif
620
621 typedef DDCAPS *LPDDCAPS;
622
623 /* DDCAPS.dwCaps */
624 #define DDCAPS_3D                       0x00000001
625 #define DDCAPS_ALIGNBOUNDARYDEST        0x00000002
626 #define DDCAPS_ALIGNSIZEDEST            0x00000004
627 #define DDCAPS_ALIGNBOUNDARYSRC         0x00000008
628 #define DDCAPS_ALIGNSIZESRC             0x00000010
629 #define DDCAPS_ALIGNSTRIDE              0x00000020
630 #define DDCAPS_BLT                      0x00000040
631 #define DDCAPS_BLTQUEUE                 0x00000080
632 #define DDCAPS_BLTFOURCC                0x00000100
633 #define DDCAPS_BLTSTRETCH               0x00000200
634 #define DDCAPS_GDI                      0x00000400
635 #define DDCAPS_OVERLAY                  0x00000800
636 #define DDCAPS_OVERLAYCANTCLIP          0x00001000
637 #define DDCAPS_OVERLAYFOURCC            0x00002000
638 #define DDCAPS_OVERLAYSTRETCH           0x00004000
639 #define DDCAPS_PALETTE                  0x00008000
640 #define DDCAPS_PALETTEVSYNC             0x00010000
641 #define DDCAPS_READSCANLINE             0x00020000
642 #define DDCAPS_STEREOVIEW               0x00040000
643 #define DDCAPS_VBI                      0x00080000
644 #define DDCAPS_ZBLTS                    0x00100000
645 #define DDCAPS_ZOVERLAYS                0x00200000
646 #define DDCAPS_COLORKEY                 0x00400000
647 #define DDCAPS_ALPHA                    0x00800000
648 #define DDCAPS_COLORKEYHWASSIST         0x01000000
649 #define DDCAPS_NOHARDWARE               0x02000000
650 #define DDCAPS_BLTCOLORFILL             0x04000000
651 #define DDCAPS_BANKSWITCHED             0x08000000
652 #define DDCAPS_BLTDEPTHFILL             0x10000000
653 #define DDCAPS_CANCLIP                  0x20000000
654 #define DDCAPS_CANCLIPSTRETCHED         0x40000000
655 #define DDCAPS_CANBLTSYSMEM             0x80000000
656
657 /* DDCAPS.dwCaps2 */
658 #define DDCAPS2_CERTIFIED               0x00000001
659 #define DDCAPS2_NO2DDURING3DSCENE       0x00000002
660 #define DDCAPS2_VIDEOPORT               0x00000004
661 #define DDCAPS2_AUTOFLIPOVERLAY         0x00000008
662 #define DDCAPS2_CANBOBINTERLEAVED       0x00000010
663 #define DDCAPS2_CANBOBNONINTERLEAVED    0x00000020
664 #define DDCAPS2_COLORCONTROLOVERLAY     0x00000040
665 #define DDCAPS2_COLORCONTROLPRIMARY     0x00000080
666 #define DDCAPS2_CANDROPZ16BIT           0x00000100
667 #define DDCAPS2_NONLOCALVIDMEM          0x00000200
668 #define DDCAPS2_NONLOCALVIDMEMCAPS      0x00000400
669 #define DDCAPS2_NOPAGELOCKREQUIRED      0x00000800
670 #define DDCAPS2_WIDESURFACES            0x00001000
671 #define DDCAPS2_CANFLIPODDEVEN          0x00002000
672 #define DDCAPS2_CANBOBHARDWARE          0x00004000
673 #define DDCAPS2_COPYFOURCC              0x00008000
674 #define DDCAPS2_PRIMARYGAMMA            0x00020000
675 #define DDCAPS2_CANRENDERWINDOWED       0x00080000
676 #define DDCAPS2_CANCALIBRATEGAMMA       0x00100000
677 #define DDCAPS2_FLIPINTERVAL            0x00200000
678 #define DDCAPS2_FLIPNOVSYNC             0x00400000
679 #define DDCAPS2_CANMANAGETEXTURE        0x00800000
680 #define DDCAPS2_TEXMANINNONLOCALVIDMEM  0x01000000
681 #define DDCAPS2_STEREO                  0x02000000
682 #define DDCAPS2_SYSTONONLOCAL_AS_SYSTOLOCAL   0x04000000
683
684
685 /* Set/Get Colour Key Flags */
686 #define DDCKEY_COLORSPACE  0x00000001  /* Struct is single colour space */
687 #define DDCKEY_DESTBLT     0x00000002  /* To be used as dest for blt */
688 #define DDCKEY_DESTOVERLAY 0x00000004  /* To be used as dest for CK overlays */
689 #define DDCKEY_SRCBLT      0x00000008  /* To be used as src for blt */
690 #define DDCKEY_SRCOVERLAY  0x00000010  /* To be used as src for CK overlays */
691
692 typedef struct _DDCOLORKEY
693 {
694         DWORD   dwColorSpaceLowValue;/* low boundary of color space that is to
695                                       * be treated as Color Key, inclusive
696                                       */
697         DWORD   dwColorSpaceHighValue;/* high boundary of color space that is
698                                        * to be treated as Color Key, inclusive
699                                        */
700 } DDCOLORKEY,*LPDDCOLORKEY;
701
702 /* ddCKEYCAPS bits */
703 #define DDCKEYCAPS_DESTBLT                      0x00000001
704 #define DDCKEYCAPS_DESTBLTCLRSPACE              0x00000002
705 #define DDCKEYCAPS_DESTBLTCLRSPACEYUV           0x00000004
706 #define DDCKEYCAPS_DESTBLTYUV                   0x00000008
707 #define DDCKEYCAPS_DESTOVERLAY                  0x00000010
708 #define DDCKEYCAPS_DESTOVERLAYCLRSPACE          0x00000020
709 #define DDCKEYCAPS_DESTOVERLAYCLRSPACEYUV       0x00000040
710 #define DDCKEYCAPS_DESTOVERLAYONEACTIVE         0x00000080
711 #define DDCKEYCAPS_DESTOVERLAYYUV               0x00000100
712 #define DDCKEYCAPS_SRCBLT                       0x00000200
713 #define DDCKEYCAPS_SRCBLTCLRSPACE               0x00000400
714 #define DDCKEYCAPS_SRCBLTCLRSPACEYUV            0x00000800
715 #define DDCKEYCAPS_SRCBLTYUV                    0x00001000
716 #define DDCKEYCAPS_SRCOVERLAY                   0x00002000
717 #define DDCKEYCAPS_SRCOVERLAYCLRSPACE           0x00004000
718 #define DDCKEYCAPS_SRCOVERLAYCLRSPACEYUV        0x00008000
719 #define DDCKEYCAPS_SRCOVERLAYONEACTIVE          0x00010000
720 #define DDCKEYCAPS_SRCOVERLAYYUV                0x00020000
721 #define DDCKEYCAPS_NOCOSTOVERLAY                0x00040000
722
723 typedef struct _DDPIXELFORMAT {
724     DWORD       dwSize;                 /* 0: size of structure */
725     DWORD       dwFlags;                /* 4: pixel format flags */
726     DWORD       dwFourCC;               /* 8: (FOURCC code) */
727     union {
728         DWORD   dwRGBBitCount;          /* C: how many bits per pixel */
729         DWORD   dwYUVBitCount;          /* C: how many bits per pixel */
730         DWORD   dwZBufferBitDepth;      /* C: how many bits for z buffers */
731         DWORD   dwAlphaBitDepth;        /* C: how many bits for alpha channels*/
732         DWORD   dwLuminanceBitCount;
733         DWORD   dwBumpBitCount;
734     } DUMMYUNIONNAME1;
735     union {
736         DWORD   dwRBitMask;             /* 10: mask for red bit*/
737         DWORD   dwYBitMask;             /* 10: mask for Y bits*/
738         DWORD   dwStencilBitDepth;
739         DWORD   dwLuminanceBitMask;
740         DWORD   dwBumpDuBitMask;
741     } DUMMYUNIONNAME2;
742     union {
743         DWORD   dwGBitMask;             /* 14: mask for green bits*/
744         DWORD   dwUBitMask;             /* 14: mask for U bits*/
745         DWORD   dwZBitMask;
746         DWORD   dwBumpDvBitMask;
747     } DUMMYUNIONNAME3;
748     union {
749         DWORD   dwBBitMask;             /* 18: mask for blue bits*/
750         DWORD   dwVBitMask;             /* 18: mask for V bits*/
751         DWORD   dwStencilBitMask;
752         DWORD   dwBumpLuminanceBitMask;
753     } DUMMYUNIONNAME4;
754     union {
755         DWORD   dwRGBAlphaBitMask;      /* 1C: mask for alpha channel */
756         DWORD   dwYUVAlphaBitMask;      /* 1C: mask for alpha channel */
757         DWORD   dwLuminanceAlphaBitMask;
758         DWORD   dwRGBZBitMask;          /* 1C: mask for Z channel */
759         DWORD   dwYUVZBitMask;          /* 1C: mask for Z channel */
760     } DUMMYUNIONNAME5;
761                                         /* 20: next structure */
762 } DDPIXELFORMAT,*LPDDPIXELFORMAT;
763
764 /* DDCAPS.dwFXCaps */
765 #define DDFXCAPS_BLTALPHA               0x00000001
766 #define DDFXCAPS_OVERLAYALPHA           0x00000004
767 #define DDFXCAPS_BLTARITHSTRETCHYN      0x00000010
768 #define DDFXCAPS_BLTARITHSTRETCHY       0x00000020
769 #define DDFXCAPS_BLTMIRRORLEFTRIGHT     0x00000040
770 #define DDFXCAPS_BLTMIRRORUPDOWN        0x00000080
771 #define DDFXCAPS_BLTROTATION            0x00000100
772 #define DDFXCAPS_BLTROTATION90          0x00000200
773 #define DDFXCAPS_BLTSHRINKX             0x00000400
774 #define DDFXCAPS_BLTSHRINKXN            0x00000800
775 #define DDFXCAPS_BLTSHRINKY             0x00001000
776 #define DDFXCAPS_BLTSHRINKYN            0x00002000
777 #define DDFXCAPS_BLTSTRETCHX            0x00004000
778 #define DDFXCAPS_BLTSTRETCHXN           0x00008000
779 #define DDFXCAPS_BLTSTRETCHY            0x00010000
780 #define DDFXCAPS_BLTSTRETCHYN           0x00020000
781 #define DDFXCAPS_OVERLAYARITHSTRETCHY   0x00040000
782 #define DDFXCAPS_OVERLAYARITHSTRETCHYN  0x00000008
783 #define DDFXCAPS_OVERLAYSHRINKX         0x00080000
784 #define DDFXCAPS_OVERLAYSHRINKXN        0x00100000
785 #define DDFXCAPS_OVERLAYSHRINKY         0x00200000
786 #define DDFXCAPS_OVERLAYSHRINKYN        0x00400000
787 #define DDFXCAPS_OVERLAYSTRETCHX        0x00800000
788 #define DDFXCAPS_OVERLAYSTRETCHXN       0x01000000
789 #define DDFXCAPS_OVERLAYSTRETCHY        0x02000000
790 #define DDFXCAPS_OVERLAYSTRETCHYN       0x04000000
791 #define DDFXCAPS_OVERLAYMIRRORLEFTRIGHT 0x08000000
792 #define DDFXCAPS_OVERLAYMIRRORUPDOWN    0x10000000
793
794 #define DDFXCAPS_OVERLAYFILTER          DDFXCAPS_OVERLAYARITHSTRETCHY
795
796 /* DDCAPS.dwFXAlphaCaps */
797 #define DDFXALPHACAPS_BLTALPHAEDGEBLEND         0x00000001
798 #define DDFXALPHACAPS_BLTALPHAPIXELS            0x00000002
799 #define DDFXALPHACAPS_BLTALPHAPIXELSNEG         0x00000004
800 #define DDFXALPHACAPS_BLTALPHASURFACES          0x00000008
801 #define DDFXALPHACAPS_BLTALPHASURFACESNEG       0x00000010
802 #define DDFXALPHACAPS_OVERLAYALPHAEDGEBLEND     0x00000020
803 #define DDFXALPHACAPS_OVERLAYALPHAPIXELS        0x00000040
804 #define DDFXALPHACAPS_OVERLAYALPHAPIXELSNEG     0x00000080
805 #define DDFXALPHACAPS_OVERLAYALPHASURFACES      0x00000100
806 #define DDFXALPHACAPS_OVERLAYALPHASURFACESNEG   0x00000200
807
808 /* DDCAPS.dwPalCaps */
809 #define DDPCAPS_4BIT                    0x00000001
810 #define DDPCAPS_8BITENTRIES             0x00000002
811 #define DDPCAPS_8BIT                    0x00000004
812 #define DDPCAPS_INITIALIZE              0x00000008
813 #define DDPCAPS_PRIMARYSURFACE          0x00000010
814 #define DDPCAPS_PRIMARYSURFACELEFT      0x00000020
815 #define DDPCAPS_ALLOW256                0x00000040
816 #define DDPCAPS_VSYNC                   0x00000080
817 #define DDPCAPS_1BIT                    0x00000100
818 #define DDPCAPS_2BIT                    0x00000200
819 #define DDPCAPS_ALPHA                   0x00000400
820
821 /* DDCAPS.dwSVCaps */
822 /* the first 4 of these are now obsolete */
823 #if DIRECTDRAW_VERSION >= 0x700 /* FIXME: I'm not sure when this switch occurred */
824 #define DDSVCAPS_RESERVED1              0x00000001
825 #define DDSVCAPS_RESERVED2              0x00000002
826 #define DDSVCAPS_RESERVED3              0x00000004
827 #define DDSVCAPS_RESERVED4              0x00000008
828 #else
829 #define DDSVCAPS_ENIGMA                 0x00000001
830 #define DDSVCAPS_FLICKER                0x00000002
831 #define DDSVCAPS_REDBLUE                0x00000004
832 #define DDSVCAPS_SPLIT                  0x00000008
833 #endif
834 #define DDSVCAPS_STEREOSEQUENTIAL       0x00000010
835
836 /* BitDepths */
837 #define DDBD_1                          0x00004000
838 #define DDBD_2                          0x00002000
839 #define DDBD_4                          0x00001000
840 #define DDBD_8                          0x00000800
841 #define DDBD_16                         0x00000400
842 #define DDBD_24                         0x00000200
843 #define DDBD_32                         0x00000100
844
845 /* DDOVERLAYFX.dwDDFX */
846 #define DDOVERFX_ARITHSTRETCHY          0x00000001
847 #define DDOVERFX_MIRRORLEFTRIGHT        0x00000002
848 #define DDOVERFX_MIRRORUPDOWN           0x00000004
849
850 /* UpdateOverlay flags */
851 #define DDOVER_ALPHADEST                        0x00000001
852 #define DDOVER_ALPHADESTCONSTOVERRIDE           0x00000002
853 #define DDOVER_ALPHADESTNEG                     0x00000004
854 #define DDOVER_ALPHADESTSURFACEOVERRIDE         0x00000008
855 #define DDOVER_ALPHAEDGEBLEND                   0x00000010
856 #define DDOVER_ALPHASRC                         0x00000020
857 #define DDOVER_ALPHASRCCONSTOVERRIDE            0x00000040
858 #define DDOVER_ALPHASRCNEG                      0x00000080
859 #define DDOVER_ALPHASRCSURFACEOVERRIDE          0x00000100
860 #define DDOVER_HIDE                             0x00000200
861 #define DDOVER_KEYDEST                          0x00000400
862 #define DDOVER_KEYDESTOVERRIDE                  0x00000800
863 #define DDOVER_KEYSRC                           0x00001000
864 #define DDOVER_KEYSRCOVERRIDE                   0x00002000
865 #define DDOVER_SHOW                             0x00004000
866 #define DDOVER_ADDDIRTYRECT                     0x00008000
867 #define DDOVER_REFRESHDIRTYRECTS                0x00010000
868 #define DDOVER_REFRESHALL                       0x00020000
869 #define DDOVER_DDFX                             0x00080000
870 #define DDOVER_AUTOFLIP                         0x00100000
871 #define DDOVER_BOB                              0x00200000
872 #define DDOVER_OVERRIDEBOBWEAVE                 0x00400000
873 #define DDOVER_INTERLEAVED                      0x00800000
874
875 /* DDCOLORKEY.dwFlags */
876 #define DDPF_ALPHAPIXELS                0x00000001
877 #define DDPF_ALPHA                      0x00000002
878 #define DDPF_FOURCC                     0x00000004
879 #define DDPF_PALETTEINDEXED4            0x00000008
880 #define DDPF_PALETTEINDEXEDTO8          0x00000010
881 #define DDPF_PALETTEINDEXED8            0x00000020
882 #define DDPF_RGB                        0x00000040
883 #define DDPF_COMPRESSED                 0x00000080
884 #define DDPF_RGBTOYUV                   0x00000100
885 #define DDPF_YUV                        0x00000200
886 #define DDPF_ZBUFFER                    0x00000400
887 #define DDPF_PALETTEINDEXED1            0x00000800
888 #define DDPF_PALETTEINDEXED2            0x00001000
889 #define DDPF_ZPIXELS                    0x00002000
890 #define DDPF_STENCILBUFFER              0x00004000
891 #define DDPF_ALPHAPREMULT               0x00008000
892 #define DDPF_LUMINANCE                  0x00020000
893 #define DDPF_BUMPLUMINANCE              0x00040000
894 #define DDPF_BUMPDUDV                   0x00080000
895
896 /* SetCooperativeLevel dwFlags */
897 #define DDSCL_FULLSCREEN                0x00000001
898 #define DDSCL_ALLOWREBOOT               0x00000002
899 #define DDSCL_NOWINDOWCHANGES           0x00000004
900 #define DDSCL_NORMAL                    0x00000008
901 #define DDSCL_EXCLUSIVE                 0x00000010
902 #define DDSCL_ALLOWMODEX                0x00000040
903 #define DDSCL_SETFOCUSWINDOW            0x00000080
904 #define DDSCL_SETDEVICEWINDOW           0x00000100
905 #define DDSCL_CREATEDEVICEWINDOW        0x00000200
906 #define DDSCL_MULTITHREADED             0x00000400
907 #define DDSCL_FPUSETUP                  0x00000800
908 #define DDSCL_FPUPRESERVE               0x00001000
909
910
911 /* DDSURFACEDESC.dwFlags */
912 #define DDSD_CAPS               0x00000001
913 #define DDSD_HEIGHT             0x00000002
914 #define DDSD_WIDTH              0x00000004
915 #define DDSD_PITCH              0x00000008
916 #define DDSD_BACKBUFFERCOUNT    0x00000020
917 #define DDSD_ZBUFFERBITDEPTH    0x00000040
918 #define DDSD_ALPHABITDEPTH      0x00000080
919 #define DDSD_LPSURFACE          0x00000800
920 #define DDSD_PIXELFORMAT        0x00001000
921 #define DDSD_CKDESTOVERLAY      0x00002000
922 #define DDSD_CKDESTBLT          0x00004000
923 #define DDSD_CKSRCOVERLAY       0x00008000
924 #define DDSD_CKSRCBLT           0x00010000
925 #define DDSD_MIPMAPCOUNT        0x00020000
926 #define DDSD_REFRESHRATE        0x00040000
927 #define DDSD_LINEARSIZE         0x00080000
928 #define DDSD_TEXTURESTAGE       0x00100000
929 #define DDSD_FVF                0x00200000
930 #define DDSD_SRCVBHANDLE        0x00400000
931 #define DDSD_ALL                0x007ff9ee
932
933 /* EnumSurfaces flags */
934 #define DDENUMSURFACES_ALL          0x00000001
935 #define DDENUMSURFACES_MATCH        0x00000002
936 #define DDENUMSURFACES_NOMATCH      0x00000004
937 #define DDENUMSURFACES_CANBECREATED 0x00000008
938 #define DDENUMSURFACES_DOESEXIST    0x00000010
939
940 /* SetDisplayMode flags */
941 #define DDSDM_STANDARDVGAMODE   0x00000001
942
943 /* EnumDisplayModes flags */
944 #define DDEDM_REFRESHRATES      0x00000001
945 #define DDEDM_STANDARDVGAMODES  0x00000002
946
947 /* WaitForVerticalDisplay flags */
948
949 #define DDWAITVB_BLOCKBEGIN             0x00000001
950 #define DDWAITVB_BLOCKBEGINEVENT        0x00000002
951 #define DDWAITVB_BLOCKEND               0x00000004
952
953 typedef struct _DDSURFACEDESC
954 {
955         DWORD   dwSize;         /* 0: size of the DDSURFACEDESC structure*/
956         DWORD   dwFlags;        /* 4: determines what fields are valid*/
957         DWORD   dwHeight;       /* 8: height of surface to be created*/
958         DWORD   dwWidth;        /* C: width of input surface*/
959         union {
960                 LONG    lPitch; /* 10: distance to start of next line (return value only)*/
961                 DWORD   dwLinearSize;
962         } DUMMYUNIONNAME1;
963         DWORD   dwBackBufferCount;/* 14: number of back buffers requested*/
964         union {
965                 DWORD   dwMipMapCount;/* 18:number of mip-map levels requested*/
966                 DWORD   dwZBufferBitDepth;/*18: depth of Z buffer requested*/
967                 DWORD   dwRefreshRate;/* 18:refresh rate (used when display mode is described)*/
968         } DUMMYUNIONNAME2;
969         DWORD   dwAlphaBitDepth;/* 1C:depth of alpha buffer requested*/
970         DWORD   dwReserved;     /* 20:reserved*/
971         LPVOID  lpSurface;      /* 24:pointer to the associated surface memory*/
972         DDCOLORKEY      ddckCKDestOverlay;/* 28: CK for dest overlay use*/
973         DDCOLORKEY      ddckCKDestBlt;  /* 30: CK for destination blt use*/
974         DDCOLORKEY      ddckCKSrcOverlay;/* 38: CK for source overlay use*/
975         DDCOLORKEY      ddckCKSrcBlt;   /* 40: CK for source blt use*/
976         DDPIXELFORMAT   ddpfPixelFormat;/* 48: pixel format description of the surface*/
977         DDSCAPS         ddsCaps;        /* 68: direct draw surface caps */
978 } DDSURFACEDESC,*LPDDSURFACEDESC;
979
980 typedef struct _DDSURFACEDESC2
981 {
982         DWORD   dwSize;         /* 0: size of the DDSURFACEDESC2 structure*/
983         DWORD   dwFlags;        /* 4: determines what fields are valid*/
984         DWORD   dwHeight;       /* 8: height of surface to be created*/
985         DWORD   dwWidth;        /* C: width of input surface*/
986         union {
987                 LONG    lPitch;       /*10: distance to start of next line (return value only)*/
988                 DWORD   dwLinearSize; /*10: formless late-allocated optimized surface size */
989         } DUMMYUNIONNAME1;
990         DWORD   dwBackBufferCount;/* 14: number of back buffers requested*/
991         union {
992                 DWORD   dwMipMapCount;/* 18:number of mip-map levels requested*/
993                 DWORD   dwRefreshRate;/* 18:refresh rate (used when display mode is described)*/
994                 DWORD   dwSrcVBHandle;/* 18:source used in VB::Optimize */
995         } DUMMYUNIONNAME2;
996         DWORD   dwAlphaBitDepth;/* 1C:depth of alpha buffer requested*/
997         DWORD   dwReserved;     /* 20:reserved*/
998         LPVOID  lpSurface;      /* 24:pointer to the associated surface memory*/
999         union {
1000                 DDCOLORKEY      ddckCKDestOverlay; /* 28: CK for dest overlay use*/
1001                 DWORD           dwEmptyFaceColor;  /* 28: color for empty cubemap faces */
1002         } DUMMYUNIONNAME3;
1003         DDCOLORKEY      ddckCKDestBlt;  /* 30: CK for destination blt use*/
1004         DDCOLORKEY      ddckCKSrcOverlay;/* 38: CK for source overlay use*/
1005         DDCOLORKEY      ddckCKSrcBlt;   /* 40: CK for source blt use*/
1006
1007         union {
1008                 DDPIXELFORMAT   ddpfPixelFormat;/* 48: pixel format description of the surface*/
1009                 DWORD           dwFVF;  /* 48: vertex format description of vertex buffers */
1010         } DUMMYUNIONNAME4;
1011         DDSCAPS2        ddsCaps;  /* 68: DDraw surface caps */
1012         DWORD           dwTextureStage; /* 78: stage in multitexture cascade */
1013 } DDSURFACEDESC2,*LPDDSURFACEDESC2;
1014
1015 /* DDCOLORCONTROL.dwFlags */
1016 #define DDCOLOR_BRIGHTNESS      0x00000001
1017 #define DDCOLOR_CONTRAST        0x00000002
1018 #define DDCOLOR_HUE             0x00000004
1019 #define DDCOLOR_SATURATION      0x00000008
1020 #define DDCOLOR_SHARPNESS       0x00000010
1021 #define DDCOLOR_GAMMA           0x00000020
1022 #define DDCOLOR_COLORENABLE     0x00000040
1023
1024 typedef struct {
1025         DWORD   dwSize;
1026         DWORD   dwFlags;
1027         LONG    lBrightness;
1028         LONG    lContrast;
1029         LONG    lHue;
1030         LONG    lSaturation;
1031         LONG    lSharpness;
1032         LONG    lGamma;
1033         LONG    lColorEnable;
1034         DWORD   dwReserved1;
1035 } DDCOLORCONTROL,*LPDDCOLORCONTROL;
1036
1037 typedef struct {
1038         WORD    red[256];
1039         WORD    green[256];
1040         WORD    blue[256];
1041 } DDGAMMARAMP,*LPDDGAMMARAMP;
1042
1043 typedef BOOL (CALLBACK *LPDDENUMCALLBACKA)(GUID *, LPSTR, LPSTR, LPVOID);
1044 typedef BOOL (CALLBACK *LPDDENUMCALLBACKW)(GUID *, LPWSTR, LPWSTR, LPVOID);
1045 DECL_WINELIB_TYPE_AW(LPDDENUMCALLBACK)
1046
1047 typedef HRESULT (CALLBACK *LPDDENUMMODESCALLBACK)(LPDDSURFACEDESC, LPVOID);
1048 typedef HRESULT (CALLBACK *LPDDENUMMODESCALLBACK2)(LPDDSURFACEDESC2, LPVOID);
1049 typedef HRESULT (CALLBACK *LPDDENUMSURFACESCALLBACK)(LPDIRECTDRAWSURFACE, LPDDSURFACEDESC, LPVOID);
1050 typedef HRESULT (CALLBACK *LPDDENUMSURFACESCALLBACK2)(LPDIRECTDRAWSURFACE4, LPDDSURFACEDESC2, LPVOID);
1051 typedef HRESULT (CALLBACK *LPDDENUMSURFACESCALLBACK7)(LPDIRECTDRAWSURFACE7, LPDDSURFACEDESC2, LPVOID);
1052
1053 typedef BOOL (CALLBACK *LPDDENUMCALLBACKEXA)(GUID *, LPSTR, LPSTR, LPVOID, HMONITOR);
1054 typedef BOOL (CALLBACK *LPDDENUMCALLBACKEXW)(GUID *, LPWSTR, LPWSTR, LPVOID, HMONITOR);
1055 DECL_WINELIB_TYPE_AW(LPDDENUMCALLBACKEX)
1056
1057 HRESULT WINAPI DirectDrawEnumerateExA( LPDDENUMCALLBACKEXA lpCallback, LPVOID lpContext, DWORD dwFlags);
1058 HRESULT WINAPI DirectDrawEnumerateExW( LPDDENUMCALLBACKEXW lpCallback, LPVOID lpContext, DWORD dwFlags);
1059 #define DirectDrawEnumerateEx WINELIB_NAME_AW(DirectDrawEnumerateEx)
1060
1061 typedef HRESULT (WINAPI * LPDIRECTDRAWENUMERATEEXA)( LPDDENUMCALLBACKEXA lpCallback, LPVOID lpContext, DWORD dwFlags);
1062 typedef HRESULT (WINAPI * LPDIRECTDRAWENUMERATEEXW)( LPDDENUMCALLBACKEXW lpCallback, LPVOID lpContext, DWORD dwFlags);
1063 DECL_WINELIB_TYPE_AW(LPDIRECTDRAWENUMERATEEX)
1064
1065 /* flags for DirectDrawEnumerateEx */
1066 #define DDENUM_ATTACHEDSECONDARYDEVICES 0x00000001
1067 #define DDENUM_DETACHEDSECONDARYDEVICES 0x00000002
1068 #define DDENUM_NONDISPLAYDEVICES        0x00000004
1069
1070 /* flags for DirectDrawCreate or IDirectDraw::Initialize */
1071 #define DDCREATE_HARDWAREONLY   1L
1072 #define DDCREATE_EMULATIONONLY  2L
1073
1074 typedef struct _DDBLTFX
1075 {
1076     DWORD       dwSize;                         /* size of structure */
1077     DWORD       dwDDFX;                         /* FX operations */
1078     DWORD       dwROP;                          /* Win32 raster operations */
1079     DWORD       dwDDROP;                        /* Raster operations new for DirectDraw */
1080     DWORD       dwRotationAngle;                /* Rotation angle for blt */
1081     DWORD       dwZBufferOpCode;                /* ZBuffer compares */
1082     DWORD       dwZBufferLow;                   /* Low limit of Z buffer */
1083     DWORD       dwZBufferHigh;                  /* High limit of Z buffer */
1084     DWORD       dwZBufferBaseDest;              /* Destination base value */
1085     DWORD       dwZDestConstBitDepth;           /* Bit depth used to specify Z constant for destination */
1086     union
1087     {
1088         DWORD   dwZDestConst;                   /* Constant to use as Z buffer for dest */
1089         LPDIRECTDRAWSURFACE lpDDSZBufferDest;   /* Surface to use as Z buffer for dest */
1090     } DUMMYUNIONNAME1;
1091     DWORD       dwZSrcConstBitDepth;            /* Bit depth used to specify Z constant for source */
1092     union
1093     {
1094         DWORD   dwZSrcConst;                    /* Constant to use as Z buffer for src */
1095         LPDIRECTDRAWSURFACE lpDDSZBufferSrc;    /* Surface to use as Z buffer for src */
1096     } DUMMYUNIONNAME2;
1097     DWORD       dwAlphaEdgeBlendBitDepth;       /* Bit depth used to specify constant for alpha edge blend */
1098     DWORD       dwAlphaEdgeBlend;               /* Alpha for edge blending */
1099     DWORD       dwReserved;
1100     DWORD       dwAlphaDestConstBitDepth;       /* Bit depth used to specify alpha constant for destination */
1101     union
1102     {
1103         DWORD   dwAlphaDestConst;               /* Constant to use as Alpha Channel */
1104         LPDIRECTDRAWSURFACE lpDDSAlphaDest;     /* Surface to use as Alpha Channel */
1105     } DUMMYUNIONNAME3;
1106     DWORD       dwAlphaSrcConstBitDepth;        /* Bit depth used to specify alpha constant for source */
1107     union
1108     {
1109         DWORD   dwAlphaSrcConst;                /* Constant to use as Alpha Channel */
1110         LPDIRECTDRAWSURFACE lpDDSAlphaSrc;      /* Surface to use as Alpha Channel */
1111     } DUMMYUNIONNAME4;
1112     union
1113     {
1114         DWORD   dwFillColor;                    /* color in RGB or Palettized */
1115         DWORD   dwFillDepth;                    /* depth value for z-buffer */
1116         DWORD   dwFillPixel;                    /* pixel val for RGBA or RGBZ */
1117         LPDIRECTDRAWSURFACE lpDDSPattern;       /* Surface to use as pattern */
1118     } DUMMYUNIONNAME5;
1119     DDCOLORKEY  ddckDestColorkey;               /* DestColorkey override */
1120     DDCOLORKEY  ddckSrcColorkey;                /* SrcColorkey override */
1121 } DDBLTFX,*LPDDBLTFX;
1122
1123 /* dwDDFX */
1124 /* arithmetic stretching along y axis */
1125 #define DDBLTFX_ARITHSTRETCHY                   0x00000001
1126 /* mirror on y axis */
1127 #define DDBLTFX_MIRRORLEFTRIGHT                 0x00000002
1128 /* mirror on x axis */
1129 #define DDBLTFX_MIRRORUPDOWN                    0x00000004
1130 /* do not tear */
1131 #define DDBLTFX_NOTEARING                       0x00000008
1132 /* 180 degrees clockwise rotation */
1133 #define DDBLTFX_ROTATE180                       0x00000010
1134 /* 270 degrees clockwise rotation */
1135 #define DDBLTFX_ROTATE270                       0x00000020
1136 /* 90 degrees clockwise rotation */
1137 #define DDBLTFX_ROTATE90                        0x00000040
1138 /* dwZBufferLow and dwZBufferHigh specify limits to the copied Z values */
1139 #define DDBLTFX_ZBUFFERRANGE                    0x00000080
1140 /* add dwZBufferBaseDest to every source z value before compare */
1141 #define DDBLTFX_ZBUFFERBASEDEST                 0x00000100
1142
1143 typedef struct _DDOVERLAYFX
1144 {
1145     DWORD       dwSize;                         /* size of structure */
1146     DWORD       dwAlphaEdgeBlendBitDepth;       /* Bit depth used to specify constant for alpha edge blend */
1147     DWORD       dwAlphaEdgeBlend;               /* Constant to use as alpha for edge blend */
1148     DWORD       dwReserved;
1149     DWORD       dwAlphaDestConstBitDepth;       /* Bit depth used to specify alpha constant for destination */
1150     union
1151     {
1152         DWORD   dwAlphaDestConst;               /* Constant to use as alpha channel for dest */
1153         LPDIRECTDRAWSURFACE lpDDSAlphaDest;     /* Surface to use as alpha channel for dest */
1154     } DUMMYUNIONNAME1;
1155     DWORD       dwAlphaSrcConstBitDepth;        /* Bit depth used to specify alpha constant for source */
1156     union
1157     {
1158         DWORD   dwAlphaSrcConst;                /* Constant to use as alpha channel for src */
1159         LPDIRECTDRAWSURFACE lpDDSAlphaSrc;      /* Surface to use as alpha channel for src */
1160     } DUMMYUNIONNAME2;
1161     DDCOLORKEY  dckDestColorkey;                /* DestColorkey override */
1162     DDCOLORKEY  dckSrcColorkey;                 /* DestColorkey override */
1163     DWORD       dwDDFX;                         /* Overlay FX */
1164     DWORD       dwFlags;                        /* flags */
1165 } DDOVERLAYFX,*LPDDOVERLAYFX;
1166
1167 typedef struct _DDBLTBATCH
1168 {
1169     LPRECT              lprDest;
1170     LPDIRECTDRAWSURFACE lpDDSSrc;
1171     LPRECT              lprSrc;
1172     DWORD               dwFlags;
1173     LPDDBLTFX           lpDDBltFx;
1174 } DDBLTBATCH,*LPDDBLTBATCH;
1175
1176 #define MAX_DDDEVICEID_STRING          512
1177
1178 typedef struct tagDDDEVICEIDENTIFIER {
1179   char    szDriver[MAX_DDDEVICEID_STRING];
1180   char    szDescription[MAX_DDDEVICEID_STRING];
1181   LARGE_INTEGER  liDriverVersion;
1182   DWORD   dwVendorId;
1183   DWORD   dwDeviceId;
1184   DWORD   dwSubSysId;
1185   DWORD   dwRevision;
1186   GUID    guidDeviceIdentifier;
1187 } DDDEVICEIDENTIFIER, * LPDDDEVICEIDENTIFIER;
1188
1189 typedef struct tagDDDEVICEIDENTIFIER2 {
1190   char    szDriver[MAX_DDDEVICEID_STRING];      /* user readable driver name */
1191   char    szDescription[MAX_DDDEVICEID_STRING]; /* user readable description */
1192   LARGE_INTEGER  liDriverVersion;               /* driver version */
1193   DWORD   dwVendorId;                           /* vendor ID, zero if unknown */
1194   DWORD   dwDeviceId;                           /* chipset ID, zero if unknown */
1195   DWORD   dwSubSysId;                           /* board ID, zero if unknown */
1196   DWORD   dwRevision;                           /* chipset version, zero if unknown */
1197   GUID    guidDeviceIdentifier;                 /* unique ID for this driver/chipset combination */
1198   DWORD   dwWHQLLevel;                          /* Windows Hardware Quality Lab certification level */
1199 } DDDEVICEIDENTIFIER2, * LPDDDEVICEIDENTIFIER2;
1200
1201 /*****************************************************************************
1202  * IDirectDrawPalette interface
1203  */
1204 #define INTERFACE IDirectDrawPalette
1205 #define IDirectDrawPalette_METHODS \
1206     IUnknown_METHODS \
1207     STDMETHOD(GetCaps)(THIS_ LPDWORD lpdwCaps) PURE; \
1208     STDMETHOD(GetEntries)(THIS_ DWORD dwFlags, DWORD dwBase, DWORD dwNumEntries, LPPALETTEENTRY lpEntries) PURE; \
1209     STDMETHOD(Initialize)(THIS_ LPDIRECTDRAW lpDD, DWORD dwFlags, LPPALETTEENTRY lpDDColorTable) PURE; \
1210     STDMETHOD(SetEntries)(THIS_ DWORD dwFlags, DWORD dwStartingEntry, DWORD dwCount, LPPALETTEENTRY lpEntries) PURE;
1211 ICOM_DEFINE(IDirectDrawPalette,IUnknown)
1212 #undef INTERFACE
1213
1214 #ifdef COBJMACROS
1215     /*** IUnknown methods ***/
1216 #define IDirectDrawPalette_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
1217 #define IDirectDrawPalette_AddRef(p)             (p)->lpVtbl->AddRef(p)
1218 #define IDirectDrawPalette_Release(p)            (p)->lpVtbl->Release(p)
1219     /*** IDirectDrawPalette methods ***/
1220 #define IDirectDrawPalette_GetCaps(p,a)          (p)->lpVtbl->GetCaps(p,a)
1221 #define IDirectDrawPalette_GetEntries(p,a,b,c,d) (p)->lpVtbl->GetEntries(p,a,b,c,d)
1222 #define IDirectDrawPalette_Initialize(p,a,b,c)   (p)->lpVtbl->Initialize(p,a,b,c)
1223 #define IDirectDrawPalette_SetEntries(p,a,b,c,d) (p)->lpVtbl->SetEntries(p,a,b,c,d)
1224 #endif
1225
1226
1227 /*****************************************************************************
1228  * IDirectDrawClipper interface
1229  */
1230 #define INTERFACE IDirectDrawClipper
1231 #define IDirectDrawClipper_METHODS \
1232     IUnknown_METHODS \
1233     STDMETHOD(GetClipList)(THIS_ LPRECT lpRect, LPRGNDATA lpClipList, LPDWORD lpdwSize) PURE; \
1234     STDMETHOD(GetHWnd)(THIS_ HWND *lphWnd) PURE; \
1235     STDMETHOD(Initialize)(THIS_ LPDIRECTDRAW lpDD, DWORD dwFlags) PURE; \
1236     STDMETHOD(IsClipListChanged)(THIS_ BOOL *lpbChanged) PURE; \
1237     STDMETHOD(SetClipList)(THIS_ LPRGNDATA lpClipList, DWORD dwFlags) PURE; \
1238     STDMETHOD(SetHWnd)(THIS_ DWORD dwFlags, HWND hWnd) PURE;
1239 ICOM_DEFINE(IDirectDrawClipper,IUnknown)
1240 #undef INTERFACE
1241
1242 #ifdef COBJMACROS
1243     /*** IUnknown methods ***/
1244 #define IDirectDrawClipper_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
1245 #define IDirectDrawClipper_AddRef(p)             (p)->lpVtbl->AddRef(p)
1246 #define IDirectDrawClipper_Release(p)            (p)->lpVtbl->Release(p)
1247     /*** IDirectDrawClipper methods ***/
1248 #define IDirectDrawClipper_GetClipList(p,a,b,c)   (p)->lpVtbl->GetClipList(p,a,b,c)
1249 #define IDirectDrawClipper_GetHWnd(p,a)           (p)->lpVtbl->GetHWnd(p,a)
1250 #define IDirectDrawClipper_Initialize(p,a,b)      (p)->lpVtbl->Initialize(p,a,b)
1251 #define IDirectDrawClipper_IsClipListChanged(p,a) (p)->lpVtbl->IsClipListChanged(p,a)
1252 #define IDirectDrawClipper_SetClipList(p,a,b)     (p)->lpVtbl->SetClipList(p,a,b)
1253 #define IDirectDrawClipper_SetHWnd(p,a,b)         (p)->lpVtbl->SetHWnd(p,a,b)
1254 #endif
1255
1256
1257 /*****************************************************************************
1258  * IDirectDraw interface
1259  */
1260 #define INTERFACE IDirectDraw
1261 #define IDirectDraw_METHODS \
1262     IUnknown_METHODS \
1263     STDMETHOD(Compact)(THIS) PURE; \
1264     STDMETHOD(CreateClipper)(THIS_ DWORD dwFlags, LPDIRECTDRAWCLIPPER *lplpDDClipper, IUnknown *pUnkOuter) PURE; \
1265     STDMETHOD(CreatePalette)(THIS_ DWORD dwFlags, LPPALETTEENTRY lpColorTable, LPDIRECTDRAWPALETTE *lplpDDPalette, IUnknown *pUnkOuter) PURE; \
1266     STDMETHOD(CreateSurface)(THIS_ LPDDSURFACEDESC lpDDSurfaceDesc, LPDIRECTDRAWSURFACE *lplpDDSurface, IUnknown *pUnkOuter) PURE; \
1267     STDMETHOD(DuplicateSurface)(THIS_ LPDIRECTDRAWSURFACE lpDDSurface, LPDIRECTDRAWSURFACE *lplpDupDDSurface) PURE; \
1268     STDMETHOD(EnumDisplayModes)(THIS_ DWORD dwFlags, LPDDSURFACEDESC lpDDSurfaceDesc, LPVOID lpContext, LPDDENUMMODESCALLBACK lpEnumModesCallback) PURE; \
1269     STDMETHOD(EnumSurfaces)(THIS_ DWORD dwFlags, LPDDSURFACEDESC lpDDSD, LPVOID lpContext, LPDDENUMSURFACESCALLBACK lpEnumSurfacesCallback) PURE; \
1270     STDMETHOD(FlipToGDISurface)(THIS) PURE; \
1271     STDMETHOD(GetCaps)(THIS_ LPDDCAPS lpDDDriverCaps, LPDDCAPS lpDDHELCaps) PURE; \
1272     STDMETHOD(GetDisplayMode)(THIS_ LPDDSURFACEDESC lpDDSurfaceDesc) PURE; \
1273     STDMETHOD(GetFourCCCodes)(THIS_ LPDWORD lpNumCodes, LPDWORD lpCodes) PURE; \
1274     STDMETHOD(GetGDISurface)(THIS_ LPDIRECTDRAWSURFACE *lplpGDIDDSurface) PURE; \
1275     STDMETHOD(GetMonitorFrequency)(THIS_ LPDWORD lpdwFrequency) PURE; \
1276     STDMETHOD(GetScanLine)(THIS_ LPDWORD lpdwScanLine) PURE; \
1277     STDMETHOD(GetVerticalBlankStatus)(THIS_ BOOL *lpbIsInVB) PURE; \
1278     STDMETHOD(Initialize)(THIS_ GUID *lpGUID) PURE; \
1279     STDMETHOD(RestoreDisplayMode)(THIS) PURE; \
1280     STDMETHOD(SetCooperativeLevel)(THIS_ HWND hWnd, DWORD dwFlags) PURE; \
1281     STDMETHOD(SetDisplayMode)(THIS_ DWORD dwWidth, DWORD dwHeight, DWORD dwBPP) PURE; \
1282     STDMETHOD(WaitForVerticalBlank)(THIS_ DWORD dwFlags, HANDLE hEvent) PURE;
1283 ICOM_DEFINE(IDirectDraw,IUnknown)
1284 #undef INTERFACE
1285
1286 #ifdef COBJMACROS
1287     /*** IUnknown methods ***/
1288 #define IDirectDraw_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
1289 #define IDirectDraw_AddRef(p)             (p)->lpVtbl->AddRef(p)
1290 #define IDirectDraw_Release(p)            (p)->lpVtbl->Release(p)
1291     /*** IDirectDraw methods ***/
1292 #define IDirectDraw_Compact(p)                  (p)->lpVtbl->Compact(p)
1293 #define IDirectDraw_CreateClipper(p,a,b,c)      (p)->lpVtbl->CreateClipper(p,a,b,c)
1294 #define IDirectDraw_CreatePalette(p,a,b,c,d)    (p)->lpVtbl->CreatePalette(p,a,b,c,d)
1295 #define IDirectDraw_CreateSurface(p,a,b,c)      (p)->lpVtbl->CreateSurface(p,a,b,c)
1296 #define IDirectDraw_DuplicateSurface(p,a,b)     (p)->lpVtbl->DuplicateSurface(p,a,b)
1297 #define IDirectDraw_EnumDisplayModes(p,a,b,c,d) (p)->lpVtbl->EnumDisplayModes(p,a,b,c,d)
1298 #define IDirectDraw_EnumSurfaces(p,a,b,c,d)     (p)->lpVtbl->EnumSurfaces(p,a,b,c,d)
1299 #define IDirectDraw_FlipToGDISurface(p)         (p)->lpVtbl->FlipToGDISurface(p)
1300 #define IDirectDraw_GetCaps(p,a,b)              (p)->lpVtbl->GetCaps(p,a,b)
1301 #define IDirectDraw_GetDisplayMode(p,a)         (p)->lpVtbl->GetDisplayMode(p,a)
1302 #define IDirectDraw_GetFourCCCodes(p,a,b)       (p)->lpVtbl->GetFourCCCodes(p,a,b)
1303 #define IDirectDraw_GetGDISurface(p,a)          (p)->lpVtbl->GetGDISurface(p,a)
1304 #define IDirectDraw_GetMonitorFrequency(p,a)    (p)->lpVtbl->GetMonitorFrequency(p,a)
1305 #define IDirectDraw_GetScanLine(p,a)            (p)->lpVtbl->GetScanLine(p,a)
1306 #define IDirectDraw_GetVerticalBlankStatus(p,a) (p)->lpVtbl->GetVerticalBlankStatus(p,a)
1307 #define IDirectDraw_Initialize(p,a)             (p)->lpVtbl->Initialize(p,a)
1308 #define IDirectDraw_RestoreDisplayMode(p)       (p)->lpVtbl->RestoreDisplayMode(p)
1309 #define IDirectDraw_SetCooperativeLevel(p,a,b)  (p)->lpVtbl->SetCooperativeLevel(p,a,b)
1310 #define IDirectDraw_SetDisplayMode(p,a,b,c)     (p)->lpVtbl->SetDisplayMode(p,a,b,c)
1311 #define IDirectDraw_WaitForVerticalBlank(p,a,b) (p)->lpVtbl->WaitForVerticalBlank(p,a,b)
1312 #endif
1313
1314
1315 /* flags for Lock() */
1316 #define DDLOCK_SURFACEMEMORYPTR 0x00000000
1317 #define DDLOCK_WAIT             0x00000001
1318 #define DDLOCK_EVENT            0x00000002
1319 #define DDLOCK_READONLY         0x00000010
1320 #define DDLOCK_WRITEONLY        0x00000020
1321 #define DDLOCK_NOSYSLOCK        0x00000800
1322 #define DDLOCK_NOOVERWRITE      0x00001000
1323 #define DDLOCK_DISCARDCONTENTS  0x00002000
1324
1325
1326 /*****************************************************************************
1327  * IDirectDraw2 interface
1328  */
1329 /* Note: IDirectDraw2 cannot derive from IDirectDraw because the number of
1330  * arguments of SetDisplayMode has changed !
1331  */
1332 #define INTERFACE IDirectDraw2
1333 #define IDirectDraw2_METHODS \
1334 /*00*/    IUnknown_METHODS \
1335 /*0c*/    STDMETHOD(Compact)(THIS) PURE; \
1336 /*10*/    STDMETHOD(CreateClipper)(THIS_ DWORD dwFlags, LPDIRECTDRAWCLIPPER *lplpDDClipper, IUnknown *pUnkOuter) PURE; \
1337 /*14*/    STDMETHOD(CreatePalette)(THIS_ DWORD dwFlags, LPPALETTEENTRY lpColorTable, LPDIRECTDRAWPALETTE *lplpDDPalette, IUnknown *pUnkOuter) PURE; \
1338 /*18*/    STDMETHOD(CreateSurface)(THIS_ LPDDSURFACEDESC lpDDSurfaceDesc, LPDIRECTDRAWSURFACE *lplpDDSurface, IUnknown *pUnkOuter) PURE; \
1339 /*1c*/    STDMETHOD(DuplicateSurface)(THIS_ LPDIRECTDRAWSURFACE lpDDSurface, LPDIRECTDRAWSURFACE *lplpDupDDSurface) PURE; \
1340 /*20*/    STDMETHOD(EnumDisplayModes)(THIS_ DWORD dwFlags, LPDDSURFACEDESC lpDDSurfaceDesc, LPVOID lpContext, LPDDENUMMODESCALLBACK lpEnumModesCallback) PURE; \
1341 /*24*/    STDMETHOD(EnumSurfaces)(THIS_ DWORD dwFlags, LPDDSURFACEDESC lpDDSD, LPVOID lpContext, LPDDENUMSURFACESCALLBACK lpEnumSurfacesCallback) PURE; \
1342 /*28*/    STDMETHOD(FlipToGDISurface)(THIS) PURE; \
1343 /*2c*/    STDMETHOD(GetCaps)(THIS_ LPDDCAPS lpDDDriverCaps, LPDDCAPS lpDDHELCaps) PURE; \
1344 /*30*/    STDMETHOD(GetDisplayMode)(THIS_ LPDDSURFACEDESC lpDDSurfaceDesc) PURE; \
1345 /*34*/    STDMETHOD(GetFourCCCodes)(THIS_ LPDWORD lpNumCodes, LPDWORD lpCodes) PURE; \
1346 /*38*/    STDMETHOD(GetGDISurface)(THIS_ LPDIRECTDRAWSURFACE *lplpGDIDDSurface) PURE; \
1347 /*3c*/    STDMETHOD(GetMonitorFrequency)(THIS_ LPDWORD lpdwFrequency) PURE; \
1348 /*40*/    STDMETHOD(GetScanLine)(THIS_ LPDWORD lpdwScanLine) PURE; \
1349 /*44*/    STDMETHOD(GetVerticalBlankStatus)(THIS_ BOOL *lpbIsInVB) PURE; \
1350 /*48*/    STDMETHOD(Initialize)(THIS_ GUID *lpGUID) PURE; \
1351 /*4c*/    STDMETHOD(RestoreDisplayMode)(THIS) PURE; \
1352 /*50*/    STDMETHOD(SetCooperativeLevel)(THIS_ HWND hWnd, DWORD dwFlags) PURE; \
1353 /*54*/    STDMETHOD(SetDisplayMode)(THIS_ DWORD dwWidth, DWORD dwHeight, DWORD dwBPP, DWORD dwRefreshRate, DWORD dwFlags) PURE; \
1354 /*58*/    STDMETHOD(WaitForVerticalBlank)(THIS_ DWORD dwFlags, HANDLE hEvent) PURE; \
1355           /* added in v2 */ \
1356 /*5c*/    STDMETHOD(GetAvailableVidMem)(THIS_ LPDDSCAPS lpDDCaps, LPDWORD lpdwTotal, LPDWORD lpdwFree) PURE;
1357 ICOM_DEFINE(IDirectDraw2,IUnknown)
1358 #undef INTERFACE
1359
1360 #ifdef COBJMACROS
1361     /*** IUnknown methods ***/
1362 #define IDirectDraw2_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
1363 #define IDirectDraw2_AddRef(p)             (p)->lpVtbl->AddRef(p)
1364 #define IDirectDraw2_Release(p)            (p)->lpVtbl->Release(p)
1365     /*** IDirectDraw methods ***/
1366 #define IDirectDraw2_Compact(p)                  (p)->lpVtbl->Compact(p)
1367 #define IDirectDraw2_CreateClipper(p,a,b,c)      (p)->lpVtbl->CreateClipper(p,a,b,c)
1368 #define IDirectDraw2_CreatePalette(p,a,b,c,d)    (p)->lpVtbl->CreatePalette(p,a,b,c,d)
1369 #define IDirectDraw2_CreateSurface(p,a,b,c)      (p)->lpVtbl->CreateSurface(p,a,b,c)
1370 #define IDirectDraw2_DuplicateSurface(p,a,b)     (p)->lpVtbl->DuplicateSurface(p,a,b)
1371 #define IDirectDraw2_EnumDisplayModes(p,a,b,c,d) (p)->lpVtbl->EnumDisplayModes(p,a,b,c,d)
1372 #define IDirectDraw2_EnumSurfaces(p,a,b,c,d)     (p)->lpVtbl->EnumSurfaces(p,a,b,c,d)
1373 #define IDirectDraw2_FlipToGDISurface(p)         (p)->lpVtbl->FlipToGDISurface(p)
1374 #define IDirectDraw2_GetCaps(p,a,b)              (p)->lpVtbl->GetCaps(p,a,b)
1375 #define IDirectDraw2_GetDisplayMode(p,a)         (p)->lpVtbl->GetDisplayMode(p,a)
1376 #define IDirectDraw2_GetFourCCCodes(p,a,b)       (p)->lpVtbl->GetFourCCCodes(p,a,b)
1377 #define IDirectDraw2_GetGDISurface(p,a)          (p)->lpVtbl->GetGDISurface(p,a)
1378 #define IDirectDraw2_GetMonitorFrequency(p,a)    (p)->lpVtbl->GetMonitorFrequency(p,a)
1379 #define IDirectDraw2_GetScanLine(p,a)            (p)->lpVtbl->GetScanLine(p,a)
1380 #define IDirectDraw2_GetVerticalBlankStatus(p,a) (p)->lpVtbl->GetVerticalBlankStatus(p,a)
1381 #define IDirectDraw2_Initialize(p,a)             (p)->lpVtbl->Initialize(p,a)
1382 #define IDirectDraw2_RestoreDisplayMode(p)       (p)->lpVtbl->RestoreDisplayMode(p)
1383 #define IDirectDraw2_SetCooperativeLevel(p,a,b)  (p)->lpVtbl->SetCooperativeLevel(p,a,b)
1384 #define IDirectDraw2_SetDisplayMode(p,a,b,c,d,e) (p)->lpVtbl->SetDisplayMode(p,a,b,c,d,e)
1385 #define IDirectDraw2_WaitForVerticalBlank(p,a,b) (p)->lpVtbl->WaitForVerticalBlank(p,a,b)
1386 /*** IDirectDraw2 methods ***/
1387 #define IDirectDraw2_GetAvailableVidMem(p,a,b,c) (p)->lpVtbl->GetAvailableVidMem(p,a,b,c)
1388 #endif
1389
1390
1391 /*****************************************************************************
1392  * IDirectDraw4 interface
1393  */
1394 #define INTERFACE IDirectDraw4
1395 #define IDirectDraw4_METHODS \
1396 /*00*/    IUnknown_METHODS \
1397 /*0c*/    STDMETHOD(Compact)(THIS) PURE; \
1398 /*10*/    STDMETHOD(CreateClipper)(THIS_ DWORD dwFlags, LPDIRECTDRAWCLIPPER *lplpDDClipper, IUnknown *pUnkOuter) PURE; \
1399 /*14*/    STDMETHOD(CreatePalette)(THIS_ DWORD dwFlags, LPPALETTEENTRY lpColorTable, LPDIRECTDRAWPALETTE *lplpDDPalette, IUnknown *pUnkOuter) PURE; \
1400 /*18*/    STDMETHOD(CreateSurface)(THIS_ LPDDSURFACEDESC2 lpDDSurfaceDesc, LPDIRECTDRAWSURFACE4 *lplpDDSurface, IUnknown *pUnkOuter) PURE; \
1401 /*1c*/    STDMETHOD(DuplicateSurface)(THIS_ LPDIRECTDRAWSURFACE4 lpDDSurface, LPDIRECTDRAWSURFACE4 *lplpDupDDSurface) PURE; \
1402 /*20*/    STDMETHOD(EnumDisplayModes)(THIS_ DWORD dwFlags, LPDDSURFACEDESC2 lpDDSurfaceDesc, LPVOID lpContext, LPDDENUMMODESCALLBACK2 lpEnumModesCallback) PURE; \
1403 /*24*/    STDMETHOD(EnumSurfaces)(THIS_ DWORD dwFlags, LPDDSURFACEDESC2 lpDDSD, LPVOID lpContext, LPDDENUMSURFACESCALLBACK2 lpEnumSurfacesCallback) PURE; \
1404 /*28*/    STDMETHOD(FlipToGDISurface)(THIS) PURE; \
1405 /*2c*/    STDMETHOD(GetCaps)(THIS_ LPDDCAPS lpDDDriverCaps, LPDDCAPS lpDDHELCaps) PURE; \
1406 /*30*/    STDMETHOD(GetDisplayMode)(THIS_ LPDDSURFACEDESC2 lpDDSurfaceDesc) PURE; \
1407 /*34*/    STDMETHOD(GetFourCCCodes)(THIS_ LPDWORD lpNumCodes, LPDWORD lpCodes) PURE; \
1408 /*38*/    STDMETHOD(GetGDISurface)(THIS_ LPDIRECTDRAWSURFACE4 *lplpGDIDDSurface) PURE; \
1409 /*3c*/    STDMETHOD(GetMonitorFrequency)(THIS_ LPDWORD lpdwFrequency) PURE; \
1410 /*40*/    STDMETHOD(GetScanLine)(THIS_ LPDWORD lpdwScanLine) PURE; \
1411 /*44*/    STDMETHOD(GetVerticalBlankStatus)(THIS_ BOOL *lpbIsInVB) PURE; \
1412 /*48*/    STDMETHOD(Initialize)(THIS_ GUID *lpGUID) PURE; \
1413 /*4c*/    STDMETHOD(RestoreDisplayMode)(THIS) PURE; \
1414 /*50*/    STDMETHOD(SetCooperativeLevel)(THIS_ HWND hWnd, DWORD dwFlags) PURE; \
1415 /*54*/    STDMETHOD(SetDisplayMode)(THIS_ DWORD dwWidth, DWORD dwHeight, DWORD dwBPP, DWORD dwRefreshRate, DWORD dwFlags) PURE; \
1416 /*58*/    STDMETHOD(WaitForVerticalBlank)(THIS_ DWORD dwFlags, HANDLE hEvent) PURE; \
1417           /* added in v2 */ \
1418 /*5c*/    STDMETHOD(GetAvailableVidMem)(THIS_ LPDDSCAPS2 lpDDCaps, LPDWORD lpdwTotal, LPDWORD lpdwFree) PURE; \
1419     /* added in v4 */ \
1420 /*60*/    STDMETHOD(GetSurfaceFromDC)(THIS_ HDC hdc, LPDIRECTDRAWSURFACE4 *pSurf) PURE; \
1421 /*64*/    STDMETHOD(RestoreAllSurfaces)(THIS) PURE; \
1422 /*68*/    STDMETHOD(TestCooperativeLevel)(THIS) PURE; \
1423 /*6c*/    STDMETHOD(GetDeviceIdentifier)(THIS_ LPDDDEVICEIDENTIFIER pDDDI, DWORD dwFlags) PURE;
1424 ICOM_DEFINE(IDirectDraw4,IUnknown)
1425 #undef INTERFACE
1426
1427 #ifdef COBJMACROS
1428     /*** IUnknown methods ***/
1429 #define IDirectDraw4_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
1430 #define IDirectDraw4_AddRef(p)             (p)->lpVtbl->AddRef(p)
1431 #define IDirectDraw4_Release(p)            (p)->lpVtbl->Release(p)
1432     /*** IDirectDraw methods ***/
1433 #define IDirectDraw4_Compact(p)                  (p)->lpVtbl->Compact(p)
1434 #define IDirectDraw4_CreateClipper(p,a,b,c)      (p)->lpVtbl->CreateClipper(p,a,b,c)
1435 #define IDirectDraw4_CreatePalette(p,a,b,c,d)    (p)->lpVtbl->CreatePalette(p,a,b,c,d)
1436 #define IDirectDraw4_CreateSurface(p,a,b,c)      (p)->lpVtbl->CreateSurface(p,a,b,c)
1437 #define IDirectDraw4_DuplicateSurface(p,a,b)     (p)->lpVtbl->DuplicateSurface(p,a,b)
1438 #define IDirectDraw4_EnumDisplayModes(p,a,b,c,d) (p)->lpVtbl->EnumDisplayModes(p,a,b,c,d)
1439 #define IDirectDraw4_EnumSurfaces(p,a,b,c,d)     (p)->lpVtbl->EnumSurfaces(p,a,b,c,d)
1440 #define IDirectDraw4_FlipToGDISurface(p)         (p)->lpVtbl->FlipToGDISurface(p)
1441 #define IDirectDraw4_GetCaps(p,a,b)              (p)->lpVtbl->GetCaps(p,a,b)
1442 #define IDirectDraw4_GetDisplayMode(p,a)         (p)->lpVtbl->GetDisplayMode(p,a)
1443 #define IDirectDraw4_GetFourCCCodes(p,a,b)       (p)->lpVtbl->GetFourCCCodes(p,a,b)
1444 #define IDirectDraw4_GetGDISurface(p,a)          (p)->lpVtbl->GetGDISurface(p,a)
1445 #define IDirectDraw4_GetMonitorFrequency(p,a)    (p)->lpVtbl->GetMonitorFrequency(p,a)
1446 #define IDirectDraw4_GetScanLine(p,a)            (p)->lpVtbl->GetScanLine(p,a)
1447 #define IDirectDraw4_GetVerticalBlankStatus(p,a) (p)->lpVtbl->GetVerticalBlankStatus(p,a)
1448 #define IDirectDraw4_Initialize(p,a)             (p)->lpVtbl->Initialize(p,a)
1449 #define IDirectDraw4_RestoreDisplayMode(p)       (p)->lpVtbl->RestoreDisplayMode(p)
1450 #define IDirectDraw4_SetCooperativeLevel(p,a,b)  (p)->lpVtbl->SetCooperativeLevel(p,a,b)
1451 #define IDirectDraw4_SetDisplayMode(p,a,b,c,d,e) (p)->lpVtbl->SetDisplayMode(p,a,b,c,d,e)
1452 #define IDirectDraw4_WaitForVerticalBlank(p,a,b) (p)->lpVtbl->WaitForVerticalBlank(p,a,b)
1453 /*** IDirectDraw2 methods ***/
1454 #define IDirectDraw4_GetAvailableVidMem(p,a,b,c) (p)->lpVtbl->GetAvailableVidMem(p,a,b,c)
1455 /*** IDirectDraw4 methods ***/
1456 #define IDirectDraw4_GetSurfaceFromDC(p,a,b)    (p)->lpVtbl->GetSurfaceFromDC(p,a,b)
1457 #define IDirectDraw4_RestoreAllSurfaces(pc)     (p)->lpVtbl->RestoreAllSurfaces(p)
1458 #define IDirectDraw4_TestCooperativeLevel(p)    (p)->lpVtbl->TestCooperativeLevel(p)
1459 #define IDirectDraw4_GetDeviceIdentifier(p,a,b) (p)->lpVtbl->GetDeviceIdentifier(p,a,b)
1460 #endif
1461
1462
1463 /*****************************************************************************
1464  * IDirectDraw7 interface
1465  */
1466 /* Note: IDirectDraw7 cannot derive from IDirectDraw4; it is even documented
1467  * as not interchangeable with earlier DirectDraw interfaces.
1468  */
1469 #define INTERFACE IDirectDraw7
1470 #define IDirectDraw7_METHODS \
1471 /*00*/    IUnknown_METHODS \
1472 /*0c*/    STDMETHOD(Compact)(THIS) PURE; \
1473 /*10*/    STDMETHOD(CreateClipper)(THIS_ DWORD dwFlags, LPDIRECTDRAWCLIPPER *lplpDDClipper, IUnknown *pUnkOuter) PURE; \
1474 /*14*/    STDMETHOD(CreatePalette)(THIS_ DWORD dwFlags, LPPALETTEENTRY lpColorTable, LPDIRECTDRAWPALETTE *lplpDDPalette, IUnknown *pUnkOuter) PURE; \
1475 /*18*/    STDMETHOD(CreateSurface)(THIS_ LPDDSURFACEDESC2 lpDDSurfaceDesc, LPDIRECTDRAWSURFACE7 *lplpDDSurface, IUnknown *pUnkOuter) PURE; \
1476 /*1c*/    STDMETHOD(DuplicateSurface)(THIS_ LPDIRECTDRAWSURFACE7 lpDDSurface, LPDIRECTDRAWSURFACE7 *lplpDupDDSurface) PURE; \
1477 /*20*/    STDMETHOD(EnumDisplayModes)(THIS_ DWORD dwFlags, LPDDSURFACEDESC2 lpDDSurfaceDesc, LPVOID lpContext, LPDDENUMMODESCALLBACK2 lpEnumModesCallback) PURE; \
1478 /*24*/    STDMETHOD(EnumSurfaces)(THIS_ DWORD dwFlags, LPDDSURFACEDESC2 lpDDSD, LPVOID lpContext, LPDDENUMSURFACESCALLBACK7 lpEnumSurfacesCallback) PURE; \
1479 /*28*/    STDMETHOD(FlipToGDISurface)(THIS) PURE; \
1480 /*2c*/    STDMETHOD(GetCaps)(THIS_ LPDDCAPS lpDDDriverCaps, LPDDCAPS lpDDHELCaps) PURE; \
1481 /*30*/    STDMETHOD(GetDisplayMode)(THIS_ LPDDSURFACEDESC2 lpDDSurfaceDesc) PURE; \
1482 /*34*/    STDMETHOD(GetFourCCCodes)(THIS_ LPDWORD lpNumCodes, LPDWORD lpCodes) PURE; \
1483 /*38*/    STDMETHOD(GetGDISurface)(THIS_ LPDIRECTDRAWSURFACE7 *lplpGDIDDSurface) PURE; \
1484 /*3c*/    STDMETHOD(GetMonitorFrequency)(THIS_ LPDWORD lpdwFrequency) PURE; \
1485 /*40*/    STDMETHOD(GetScanLine)(THIS_ LPDWORD lpdwScanLine) PURE; \
1486 /*44*/    STDMETHOD(GetVerticalBlankStatus)(THIS_ BOOL *lpbIsInVB) PURE; \
1487 /*48*/    STDMETHOD(Initialize)(THIS_ GUID *lpGUID) PURE; \
1488 /*4c*/    STDMETHOD(RestoreDisplayMode)(THIS) PURE; \
1489 /*50*/    STDMETHOD(SetCooperativeLevel)(THIS_ HWND hWnd, DWORD dwFlags) PURE; \
1490 /*54*/    STDMETHOD(SetDisplayMode)(THIS_ DWORD dwWidth, DWORD dwHeight, DWORD dwBPP, DWORD dwRefreshRate, DWORD dwFlags) PURE; \
1491 /*58*/    STDMETHOD(WaitForVerticalBlank)(THIS_ DWORD dwFlags, HANDLE hEvent) PURE; \
1492           /* added in v2 */ \
1493 /*5c*/    STDMETHOD(GetAvailableVidMem)(THIS_ LPDDSCAPS2 lpDDCaps, LPDWORD lpdwTotal, LPDWORD lpdwFree) PURE; \
1494           /* added in v4 */ \
1495 /*60*/    STDMETHOD(GetSurfaceFromDC)(THIS_ HDC hdc, LPDIRECTDRAWSURFACE7 *pSurf) PURE; \
1496 /*64*/    STDMETHOD(RestoreAllSurfaces)(THIS) PURE; \
1497 /*68*/    STDMETHOD(TestCooperativeLevel)(THIS) PURE; \
1498 /*6c*/    STDMETHOD(GetDeviceIdentifier)(THIS_ LPDDDEVICEIDENTIFIER2 pDDDI, DWORD dwFlags) PURE; \
1499           /* added in v7 */ \
1500 /*70*/    STDMETHOD(StartModeTest)(THIS_ LPSIZE pModes, DWORD dwNumModes, DWORD dwFlags) PURE; \
1501 /*74*/    STDMETHOD(EvaluateMode)(THIS_ DWORD dwFlags, DWORD  *pTimeout) PURE;
1502 ICOM_DEFINE(IDirectDraw7,IUnknown)
1503 #undef INTERFACE
1504
1505 #ifdef COBJMACROS
1506     /*** IUnknown methods ***/
1507 #define IDirectDraw7_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
1508 #define IDirectDraw7_AddRef(p)             (p)->lpVtbl->AddRef(p)
1509 #define IDirectDraw7_Release(p)            (p)->lpVtbl->Release(p)
1510     /*** IDirectDraw methods ***/
1511 #define IDirectDraw7_Compact(p)                  (p)->lpVtbl->Compact(p)
1512 #define IDirectDraw7_CreateClipper(p,a,b,c)      (p)->lpVtbl->CreateClipper(p,a,b,c)
1513 #define IDirectDraw7_CreatePalette(p,a,b,c,d)    (p)->lpVtbl->CreatePalette(p,a,b,c,d)
1514 #define IDirectDraw7_CreateSurface(p,a,b,c)      (p)->lpVtbl->CreateSurface(p,a,b,c)
1515 #define IDirectDraw7_DuplicateSurface(p,a,b)     (p)->lpVtbl->DuplicateSurface(p,a,b)
1516 #define IDirectDraw7_EnumDisplayModes(p,a,b,c,d) (p)->lpVtbl->EnumDisplayModes(p,a,b,c,d)
1517 #define IDirectDraw7_EnumSurfaces(p,a,b,c,d)     (p)->lpVtbl->EnumSurfaces(p,a,b,c,d)
1518 #define IDirectDraw7_FlipToGDISurface(p)         (p)->lpVtbl->FlipToGDISurface(p)
1519 #define IDirectDraw7_GetCaps(p,a,b)              (p)->lpVtbl->GetCaps(p,a,b)
1520 #define IDirectDraw7_GetDisplayMode(p,a)         (p)->lpVtbl->GetDisplayMode(p,a)
1521 #define IDirectDraw7_GetFourCCCodes(p,a,b)       (p)->lpVtbl->GetFourCCCodes(p,a,b)
1522 #define IDirectDraw7_GetGDISurface(p,a)          (p)->lpVtbl->GetGDISurface(p,a)
1523 #define IDirectDraw7_GetMonitorFrequency(p,a)    (p)->lpVtbl->GetMonitorFrequency(p,a)
1524 #define IDirectDraw7_GetScanLine(p,a)            (p)->lpVtbl->GetScanLine(p,a)
1525 #define IDirectDraw7_GetVerticalBlankStatus(p,a) (p)->lpVtbl->GetVerticalBlankStatus(p,a)
1526 #define IDirectDraw7_Initialize(p,a)             (p)->lpVtbl->Initialize(p,a)
1527 #define IDirectDraw7_RestoreDisplayMode(p)       (p)->lpVtbl->RestoreDisplayMode(p)
1528 #define IDirectDraw7_SetCooperativeLevel(p,a,b)  (p)->lpVtbl->SetCooperativeLevel(p,a,b)
1529 #define IDirectDraw7_SetDisplayMode(p,a,b,c,d,e) (p)->lpVtbl->SetDisplayMode(p,a,b,c,d,e)
1530 #define IDirectDraw7_WaitForVerticalBlank(p,a,b) (p)->lpVtbl->WaitForVerticalBlank(p,a,b)
1531 /*** added in IDirectDraw2 ***/
1532 #define IDirectDraw7_GetAvailableVidMem(p,a,b,c) (p)->lpVtbl->GetAvailableVidMem(p,a,b,c)
1533 /*** added in IDirectDraw4 ***/
1534 #define IDirectDraw7_GetSurfaceFromDC(p,a,b)    (p)->lpVtbl->GetSurfaceFromDC(p,a,b)
1535 #define IDirectDraw7_RestoreAllSurfaces(p)     (p)->lpVtbl->RestoreAllSurfaces(p)
1536 #define IDirectDraw7_TestCooperativeLevel(p)    (p)->lpVtbl->TestCooperativeLevel(p)
1537 #define IDirectDraw7_GetDeviceIdentifier(p,a,b) (p)->lpVtbl->GetDeviceIdentifier(p,a,b)
1538 /*** added in IDirectDraw 7 ***/
1539 #define IDirectDraw7_StartModeTest(p,a,b,c)     (p)->lpVtbl->StartModeTest(p,a,b,c)
1540 #define IDirectDraw7_EvaluateMode(p,a,b)        (p)->lpVtbl->EvaluateMode(p,a,b)
1541 #endif
1542
1543
1544 /*****************************************************************************
1545  * IDirectDrawSurface interface
1546  */
1547 #define INTERFACE IDirectDrawSurface
1548 #define IDirectDrawSurface_METHODS \
1549 /*00*/    IUnknown_METHODS \
1550 /*0c*/    STDMETHOD(AddAttachedSurface)(THIS_ LPDIRECTDRAWSURFACE lpDDSAttachedSurface) PURE; \
1551 /*10*/    STDMETHOD(AddOverlayDirtyRect)(THIS_ LPRECT lpRect) PURE; \
1552 /*14*/    STDMETHOD(Blt)(THIS_ LPRECT lpDestRect, LPDIRECTDRAWSURFACE lpDDSrcSurface, LPRECT lpSrcRect, DWORD dwFlags, LPDDBLTFX lpDDBltFx) PURE; \
1553 /*18*/    STDMETHOD(BltBatch)(THIS_ LPDDBLTBATCH lpDDBltBatch, DWORD dwCount, DWORD dwFlags) PURE; \
1554 /*1c*/    STDMETHOD(BltFast)(THIS_ DWORD dwX, DWORD dwY, LPDIRECTDRAWSURFACE lpDDSrcSurface, LPRECT lpSrcRect, DWORD dwTrans) PURE; \
1555 /*20*/    STDMETHOD(DeleteAttachedSurface)(THIS_ DWORD dwFlags, LPDIRECTDRAWSURFACE lpDDSAttachedSurface) PURE; \
1556 /*24*/    STDMETHOD(EnumAttachedSurfaces)(THIS_ LPVOID lpContext, LPDDENUMSURFACESCALLBACK lpEnumSurfacesCallback) PURE; \
1557 /*28*/    STDMETHOD(EnumOverlayZOrders)(THIS_ DWORD dwFlags, LPVOID lpContext, LPDDENUMSURFACESCALLBACK lpfnCallback) PURE; \
1558 /*2c*/    STDMETHOD(Flip)(THIS_ LPDIRECTDRAWSURFACE lpDDSurfaceTargetOverride, DWORD dwFlags) PURE; \
1559 /*30*/    STDMETHOD(GetAttachedSurface)(THIS_ LPDDSCAPS lpDDSCaps, LPDIRECTDRAWSURFACE *lplpDDAttachedSurface) PURE; \
1560 /*34*/    STDMETHOD(GetBltStatus)(THIS_ DWORD dwFlags) PURE; \
1561 /*38*/    STDMETHOD(GetCaps)(THIS_ LPDDSCAPS lpDDSCaps) PURE; \
1562 /*3c*/    STDMETHOD(GetClipper)(THIS_ LPDIRECTDRAWCLIPPER *lplpDDClipper) PURE; \
1563 /*40*/    STDMETHOD(GetColorKey)(THIS_ DWORD dwFlags, LPDDCOLORKEY lpDDColorKey) PURE; \
1564 /*44*/    STDMETHOD(GetDC)(THIS_ HDC *lphDC) PURE; \
1565 /*48*/    STDMETHOD(GetFlipStatus)(THIS_ DWORD dwFlags) PURE; \
1566 /*4c*/    STDMETHOD(GetOverlayPosition)(THIS_ LPLONG lplX, LPLONG lplY) PURE; \
1567 /*50*/    STDMETHOD(GetPalette)(THIS_ LPDIRECTDRAWPALETTE *lplpDDPalette) PURE; \
1568 /*54*/    STDMETHOD(GetPixelFormat)(THIS_ LPDDPIXELFORMAT lpDDPixelFormat) PURE; \
1569 /*58*/    STDMETHOD(GetSurfaceDesc)(THIS_ LPDDSURFACEDESC lpDDSurfaceDesc) PURE; \
1570 /*5c*/    STDMETHOD(Initialize)(THIS_ LPDIRECTDRAW lpDD, LPDDSURFACEDESC lpDDSurfaceDesc) PURE; \
1571 /*60*/    STDMETHOD(IsLost)(THIS) PURE; \
1572 /*64*/    STDMETHOD(Lock)(THIS_ LPRECT lpDestRect, LPDDSURFACEDESC lpDDSurfaceDesc, DWORD dwFlags, HANDLE hEvent) PURE; \
1573 /*68*/    STDMETHOD(ReleaseDC)(THIS_ HDC hDC) PURE; \
1574 /*6c*/    STDMETHOD(Restore)(THIS) PURE; \
1575 /*70*/    STDMETHOD(SetClipper)(THIS_ LPDIRECTDRAWCLIPPER lpDDClipper) PURE; \
1576 /*74*/    STDMETHOD(SetColorKey)(THIS_ DWORD dwFlags, LPDDCOLORKEY lpDDColorKey) PURE; \
1577 /*78*/    STDMETHOD(SetOverlayPosition)(THIS_ LONG lX, LONG lY) PURE; \
1578 /*7c*/    STDMETHOD(SetPalette)(THIS_ LPDIRECTDRAWPALETTE lpDDPalette) PURE; \
1579 /*80*/    STDMETHOD(Unlock)(THIS_ LPVOID lpSurfaceData) PURE; \
1580 /*84*/    STDMETHOD(UpdateOverlay)(THIS_ LPRECT lpSrcRect, LPDIRECTDRAWSURFACE lpDDDestSurface, LPRECT lpDestRect, DWORD dwFlags, LPDDOVERLAYFX lpDDOverlayFx) PURE; \
1581 /*88*/    STDMETHOD(UpdateOverlayDisplay)(THIS_ DWORD dwFlags) PURE; \
1582 /*8c*/    STDMETHOD(UpdateOverlayZOrder)(THIS_ DWORD dwFlags, LPDIRECTDRAWSURFACE lpDDSReference) PURE;
1583 ICOM_DEFINE(IDirectDrawSurface,IUnknown)
1584 #undef INTERFACE
1585
1586 #ifdef COBJMACROS
1587     /*** IUnknown methods ***/
1588 #define IDirectDrawSurface_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
1589 #define IDirectDrawSurface_AddRef(p)             (p)->lpVtbl->AddRef(p)
1590 #define IDirectDrawSurface_Release(p)            (p)->lpVtbl->Release(p)
1591     /*** IDirectDrawSurface methods ***/
1592 #define IDirectDrawSurface_AddAttachedSurface(p,a)      (p)->lpVtbl->AddAttachedSurface(p,a)
1593 #define IDirectDrawSurface_AddOverlayDirtyRect(p,a)     (p)->lpVtbl->AddOverlayDirtyRect(p,a)
1594 #define IDirectDrawSurface_Blt(p,a,b,c,d,e)             (p)->lpVtbl->Blt(p,a,b,c,d,e)
1595 #define IDirectDrawSurface_BltBatch(p,a,b,c)            (p)->lpVtbl->BltBatch(p,a,b,c)
1596 #define IDirectDrawSurface_BltFast(p,a,b,c,d,e)         (p)->lpVtbl->BltFast(p,a,b,c,d,e)
1597 #define IDirectDrawSurface_DeleteAttachedSurface(p,a,b) (p)->lpVtbl->DeleteAttachedSurface(p,a,b)
1598 #define IDirectDrawSurface_EnumAttachedSurfaces(p,a,b)  (p)->lpVtbl->EnumAttachedSurfaces(p,a,b)
1599 #define IDirectDrawSurface_EnumOverlayZOrders(p,a,b,c)  (p)->lpVtbl->EnumOverlayZOrders(p,a,b,c)
1600 #define IDirectDrawSurface_Flip(p,a,b)                  (p)->lpVtbl->Flip(p,a,b)
1601 #define IDirectDrawSurface_GetAttachedSurface(p,a,b)    (p)->lpVtbl->GetAttachedSurface(p,a,b)
1602 #define IDirectDrawSurface_GetBltStatus(p,a)            (p)->lpVtbl->GetBltStatus(p,a)
1603 #define IDirectDrawSurface_GetCaps(p,a)                 (p)->lpVtbl->GetCaps(p,a)
1604 #define IDirectDrawSurface_GetClipper(p,a)              (p)->lpVtbl->GetClipper(p,a)
1605 #define IDirectDrawSurface_GetColorKey(p,a,b)           (p)->lpVtbl->GetColorKey(p,a,b)
1606 #define IDirectDrawSurface_GetDC(p,a)                   (p)->lpVtbl->GetDC(p,a)
1607 #define IDirectDrawSurface_GetFlipStatus(p,a)           (p)->lpVtbl->GetFlipStatus(p,a)
1608 #define IDirectDrawSurface_GetOverlayPosition(p,a,b)    (p)->lpVtbl->GetOverlayPosition(p,a,b)
1609 #define IDirectDrawSurface_GetPalette(p,a)              (p)->lpVtbl->GetPalette(p,a)
1610 #define IDirectDrawSurface_GetPixelFormat(p,a)          (p)->lpVtbl->GetPixelFormat(p,a)
1611 #define IDirectDrawSurface_GetSurfaceDesc(p,a)          (p)->lpVtbl->GetSurfaceDesc(p,a)
1612 #define IDirectDrawSurface_Initialize(p,a,b)            (p)->lpVtbl->Initialize(p,a,b)
1613 #define IDirectDrawSurface_IsLost(p)                    (p)->lpVtbl->IsLost(p)
1614 #define IDirectDrawSurface_Lock(p,a,b,c,d)              (p)->lpVtbl->Lock(p,a,b,c,d)
1615 #define IDirectDrawSurface_ReleaseDC(p,a)               (p)->lpVtbl->ReleaseDC(p,a)
1616 #define IDirectDrawSurface_Restore(p)                   (p)->lpVtbl->Restore(p)
1617 #define IDirectDrawSurface_SetClipper(p,a)              (p)->lpVtbl->SetClipper(p,a)
1618 #define IDirectDrawSurface_SetColorKey(p,a,b)           (p)->lpVtbl->SetColorKey(p,a,b)
1619 #define IDirectDrawSurface_SetOverlayPosition(p,a,b)    (p)->lpVtbl->SetOverlayPosition(p,a,b)
1620 #define IDirectDrawSurface_SetPalette(p,a)              (p)->lpVtbl->SetPalette(p,a)
1621 #define IDirectDrawSurface_Unlock(p,a)                  (p)->lpVtbl->Unlock(p,a)
1622 #define IDirectDrawSurface_UpdateOverlay(p,a,b,c,d,e)   (p)->lpVtbl->UpdateOverlay(p,a,b,c,d,e)
1623 #define IDirectDrawSurface_UpdateOverlayDisplay(p,a)    (p)->lpVtbl->UpdateOverlayDisplay(p,a)
1624 #define IDirectDrawSurface_UpdateOverlayZOrder(p,a,b)   (p)->lpVtbl->UpdateOverlayZOrder(p,a,b)
1625 #endif
1626
1627
1628 /*****************************************************************************
1629  * IDirectDrawSurface2 interface
1630  */
1631 /* Cannot inherit from IDirectDrawSurface because the LPDIRECTDRAWSURFACE parameters
1632  * have been converted to LPDIRECTDRAWSURFACE2.
1633  */
1634 #define INTERFACE IDirectDrawSurface2
1635 #define IDirectDrawSurface2_METHODS \
1636     IUnknown_METHODS \
1637     STDMETHOD(AddAttachedSurface)(THIS_ LPDIRECTDRAWSURFACE2 lpDDSAttachedSurface) PURE; \
1638     STDMETHOD(AddOverlayDirtyRect)(THIS_ LPRECT lpRect) PURE; \
1639     STDMETHOD(Blt)(THIS_ LPRECT lpDestRect, LPDIRECTDRAWSURFACE2 lpDDSrcSurface, LPRECT lpSrcRect, DWORD dwFlags, LPDDBLTFX lpDDBltFx) PURE; \
1640     STDMETHOD(BltBatch)(THIS_ LPDDBLTBATCH lpDDBltBatch, DWORD dwCount, DWORD dwFlags) PURE; \
1641     STDMETHOD(BltFast)(THIS_ DWORD dwX, DWORD dwY, LPDIRECTDRAWSURFACE2 lpDDSrcSurface, LPRECT lpSrcRect, DWORD dwTrans) PURE; \
1642     STDMETHOD(DeleteAttachedSurface)(THIS_ DWORD dwFlags, LPDIRECTDRAWSURFACE2 lpDDSAttachedSurface) PURE; \
1643     STDMETHOD(EnumAttachedSurfaces)(THIS_ LPVOID lpContext, LPDDENUMSURFACESCALLBACK lpEnumSurfacesCallback) PURE; \
1644     STDMETHOD(EnumOverlayZOrders)(THIS_ DWORD dwFlags, LPVOID lpContext, LPDDENUMSURFACESCALLBACK lpfnCallback) PURE; \
1645     STDMETHOD(Flip)(THIS_ LPDIRECTDRAWSURFACE2 lpDDSurfaceTargetOverride, DWORD dwFlags) PURE; \
1646     STDMETHOD(GetAttachedSurface)(THIS_ LPDDSCAPS lpDDSCaps, LPDIRECTDRAWSURFACE2 *lplpDDAttachedSurface) PURE; \
1647     STDMETHOD(GetBltStatus)(THIS_ DWORD dwFlags) PURE; \
1648     STDMETHOD(GetCaps)(THIS_ LPDDSCAPS lpDDSCaps) PURE; \
1649     STDMETHOD(GetClipper)(THIS_ LPDIRECTDRAWCLIPPER *lplpDDClipper) PURE; \
1650     STDMETHOD(GetColorKey)(THIS_ DWORD dwFlags, LPDDCOLORKEY lpDDColorKey) PURE; \
1651     STDMETHOD(GetDC)(THIS_ HDC *lphDC) PURE; \
1652     STDMETHOD(GetFlipStatus)(THIS_ DWORD dwFlags) PURE; \
1653     STDMETHOD(GetOverlayPosition)(THIS_ LPLONG lplX, LPLONG lplY) PURE; \
1654     STDMETHOD(GetPalette)(THIS_ LPDIRECTDRAWPALETTE *lplpDDPalette) PURE; \
1655     STDMETHOD(GetPixelFormat)(THIS_ LPDDPIXELFORMAT lpDDPixelFormat) PURE; \
1656     STDMETHOD(GetSurfaceDesc)(THIS_ LPDDSURFACEDESC lpDDSurfaceDesc) PURE; \
1657     STDMETHOD(Initialize)(THIS_ LPDIRECTDRAW lpDD, LPDDSURFACEDESC lpDDSurfaceDesc) PURE; \
1658     STDMETHOD(IsLost)(THIS) PURE; \
1659     STDMETHOD(Lock)(THIS_ LPRECT lpDestRect, LPDDSURFACEDESC lpDDSurfaceDesc, DWORD dwFlags, HANDLE hEvent) PURE; \
1660     STDMETHOD(ReleaseDC)(THIS_ HDC hDC) PURE; \
1661     STDMETHOD(Restore)(THIS) PURE; \
1662     STDMETHOD(SetClipper)(THIS_ LPDIRECTDRAWCLIPPER lpDDClipper) PURE; \
1663     STDMETHOD(SetColorKey)(THIS_ DWORD dwFlags, LPDDCOLORKEY lpDDColorKey) PURE; \
1664     STDMETHOD(SetOverlayPosition)(THIS_ LONG lX, LONG lY) PURE; \
1665     STDMETHOD(SetPalette)(THIS_ LPDIRECTDRAWPALETTE lpDDPalette) PURE; \
1666     STDMETHOD(Unlock)(THIS_ LPVOID lpSurfaceData) PURE; \
1667     STDMETHOD(UpdateOverlay)(THIS_ LPRECT lpSrcRect, LPDIRECTDRAWSURFACE2 lpDDDestSurface, LPRECT lpDestRect, DWORD dwFlags, LPDDOVERLAYFX lpDDOverlayFx) PURE; \
1668     STDMETHOD(UpdateOverlayDisplay)(THIS_ DWORD dwFlags) PURE; \
1669     STDMETHOD(UpdateOverlayZOrder)(THIS_ DWORD dwFlags, LPDIRECTDRAWSURFACE2 lpDDSReference) PURE; \
1670     /* added in v2 */ \
1671     STDMETHOD(GetDDInterface)(THIS_ LPVOID *lplpDD) PURE; \
1672     STDMETHOD(PageLock)(THIS_ DWORD dwFlags) PURE; \
1673     STDMETHOD(PageUnlock)(THIS_ DWORD dwFlags) PURE;
1674 ICOM_DEFINE(IDirectDrawSurface2,IUnknown)
1675 #undef INTERFACE
1676
1677 #ifdef COBJMACROS
1678     /*** IUnknown methods ***/
1679 #define IDirectDrawSurface2_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
1680 #define IDirectDrawSurface2_AddRef(p)             (p)->lpVtbl->AddRef(p)
1681 #define IDirectDrawSurface2_Release(p)            (p)->lpVtbl->Release(p)
1682 /*** IDirectDrawSurface methods (almost) ***/
1683 #define IDirectDrawSurface2_AddAttachedSurface(p,a)      (p)->lpVtbl->AddAttachedSurface(p,a)
1684 #define IDirectDrawSurface2_AddOverlayDirtyRect(p,a)     (p)->lpVtbl->AddOverlayDirtyRect(p,a)
1685 #define IDirectDrawSurface2_Blt(p,a,b,c,d,e)             (p)->lpVtbl->Blt(p,a,b,c,d,e)
1686 #define IDirectDrawSurface2_BltBatch(p,a,b,c)            (p)->lpVtbl->BltBatch(p,a,b,c)
1687 #define IDirectDrawSurface2_BltFast(p,a,b,c,d,e)         (p)->lpVtbl->BltFast(p,a,b,c,d,e)
1688 #define IDirectDrawSurface2_DeleteAttachedSurface(p,a,b) (p)->lpVtbl->DeleteAttachedSurface(p,a,b)
1689 #define IDirectDrawSurface2_EnumAttachedSurfaces(p,a,b)  (p)->lpVtbl->EnumAttachedSurfaces(p,a,b)
1690 #define IDirectDrawSurface2_EnumOverlayZOrders(p,a,b,c)  (p)->lpVtbl->EnumOverlayZOrders(p,a,b,c)
1691 #define IDirectDrawSurface2_Flip(p,a,b)                  (p)->lpVtbl->Flip(p,a,b)
1692 #define IDirectDrawSurface2_GetAttachedSurface(p,a,b)    (p)->lpVtbl->GetAttachedSurface(p,a,b)
1693 #define IDirectDrawSurface2_GetBltStatus(p,a)            (p)->lpVtbl->GetBltStatus(p,a)
1694 #define IDirectDrawSurface2_GetCaps(p,a)                 (p)->lpVtbl->GetCaps(p,a)
1695 #define IDirectDrawSurface2_GetClipper(p,a)              (p)->lpVtbl->GetClipper(p,a)
1696 #define IDirectDrawSurface2_GetColorKey(p,a,b)           (p)->lpVtbl->GetColorKey(p,a,b)
1697 #define IDirectDrawSurface2_GetDC(p,a)                   (p)->lpVtbl->GetDC(p,a)
1698 #define IDirectDrawSurface2_GetFlipStatus(p,a)           (p)->lpVtbl->GetFlipStatus(p,a)
1699 #define IDirectDrawSurface2_GetOverlayPosition(p,a,b)    (p)->lpVtbl->GetOverlayPosition(p,a,b)
1700 #define IDirectDrawSurface2_GetPalette(p,a)              (p)->lpVtbl->GetPalette(p,a)
1701 #define IDirectDrawSurface2_GetPixelFormat(p,a)          (p)->lpVtbl->GetPixelFormat(p,a)
1702 #define IDirectDrawSurface2_GetSurfaceDesc(p,a)          (p)->lpVtbl->GetSurfaceDesc(p,a)
1703 #define IDirectDrawSurface2_Initialize(p,a,b)            (p)->lpVtbl->Initialize(p,a,b)
1704 #define IDirectDrawSurface2_IsLost(p)                    (p)->lpVtbl->IsLost(p)
1705 #define IDirectDrawSurface2_Lock(p,a,b,c,d)              (p)->lpVtbl->Lock(p,a,b,c,d)
1706 #define IDirectDrawSurface2_ReleaseDC(p,a)               (p)->lpVtbl->ReleaseDC(p,a)
1707 #define IDirectDrawSurface2_Restore(p)                   (p)->lpVtbl->Restore(p)
1708 #define IDirectDrawSurface2_SetClipper(p,a)              (p)->lpVtbl->SetClipper(p,a)
1709 #define IDirectDrawSurface2_SetColorKey(p,a,b)           (p)->lpVtbl->SetColorKey(p,a,b)
1710 #define IDirectDrawSurface2_SetOverlayPosition(p,a,b)    (p)->lpVtbl->SetOverlayPosition(p,a,b)
1711 #define IDirectDrawSurface2_SetPalette(p,a)              (p)->lpVtbl->SetPalette(p,a)
1712 #define IDirectDrawSurface2_Unlock(p,a)                  (p)->lpVtbl->Unlock(p,a)
1713 #define IDirectDrawSurface2_UpdateOverlay(p,a,b,c,d,e)   (p)->lpVtbl->UpdateOverlay(p,a,b,c,d,e)
1714 #define IDirectDrawSurface2_UpdateOverlayDisplay(p,a)    (p)->lpVtbl->UpdateOverlayDisplay(p,a)
1715 #define IDirectDrawSurface2_UpdateOverlayZOrder(p,a,b)   (p)->lpVtbl->UpdateOverlayZOrder(p,a,b)
1716 /*** IDirectDrawSurface2 methods ***/
1717 #define IDirectDrawSurface2_GetDDInterface(p,a) (p)->lpVtbl->GetDDInterface(p,a)
1718 #define IDirectDrawSurface2_PageLock(p,a)       (p)->lpVtbl->PageLock(p,a)
1719 #define IDirectDrawSurface2_PageUnlock(p,a)     (p)->lpVtbl->PageUnlock(p,a)
1720 #endif
1721
1722
1723 /*****************************************************************************
1724  * IDirectDrawSurface3 interface
1725  */
1726 /* Cannot inherit from IDirectDrawSurface2 because the LPDIRECTDRAWSURFACE2 parameters
1727  * have been converted to LPDIRECTDRAWSURFACE3.
1728  */
1729 #define INTERFACE IDirectDrawSurface3
1730 #define IDirectDrawSurface3_METHODS \
1731     IUnknown_METHODS \
1732     STDMETHOD(AddAttachedSurface)(THIS_ LPDIRECTDRAWSURFACE3 lpDDSAttachedSurface) PURE; \
1733     STDMETHOD(AddOverlayDirtyRect)(THIS_ LPRECT lpRect) PURE; \
1734     STDMETHOD(Blt)(THIS_ LPRECT lpDestRect, LPDIRECTDRAWSURFACE3 lpDDSrcSurface, LPRECT lpSrcRect, DWORD dwFlags, LPDDBLTFX lpDDBltFx) PURE; \
1735     STDMETHOD(BltBatch)(THIS_ LPDDBLTBATCH lpDDBltBatch, DWORD dwCount, DWORD dwFlags) PURE; \
1736     STDMETHOD(BltFast)(THIS_ DWORD dwX, DWORD dwY, LPDIRECTDRAWSURFACE3 lpDDSrcSurface, LPRECT lpSrcRect, DWORD dwTrans) PURE; \
1737     STDMETHOD(DeleteAttachedSurface)(THIS_ DWORD dwFlags, LPDIRECTDRAWSURFACE3 lpDDSAttachedSurface) PURE; \
1738     STDMETHOD(EnumAttachedSurfaces)(THIS_ LPVOID lpContext, LPDDENUMSURFACESCALLBACK lpEnumSurfacesCallback) PURE; \
1739     STDMETHOD(EnumOverlayZOrders)(THIS_ DWORD dwFlags, LPVOID lpContext, LPDDENUMSURFACESCALLBACK lpfnCallback) PURE; \
1740     STDMETHOD(Flip)(THIS_ LPDIRECTDRAWSURFACE3 lpDDSurfaceTargetOverride, DWORD dwFlags) PURE; \
1741     STDMETHOD(GetAttachedSurface)(THIS_ LPDDSCAPS lpDDSCaps, LPDIRECTDRAWSURFACE3 *lplpDDAttachedSurface) PURE; \
1742     STDMETHOD(GetBltStatus)(THIS_ DWORD dwFlags) PURE; \
1743     STDMETHOD(GetCaps)(THIS_ LPDDSCAPS lpDDSCaps) PURE; \
1744     STDMETHOD(GetClipper)(THIS_ LPDIRECTDRAWCLIPPER *lplpDDClipper) PURE; \
1745     STDMETHOD(GetColorKey)(THIS_ DWORD dwFlags, LPDDCOLORKEY lpDDColorKey) PURE; \
1746     STDMETHOD(GetDC)(THIS_ HDC *lphDC) PURE; \
1747     STDMETHOD(GetFlipStatus)(THIS_ DWORD dwFlags) PURE; \
1748     STDMETHOD(GetOverlayPosition)(THIS_ LPLONG lplX, LPLONG lplY) PURE; \
1749     STDMETHOD(GetPalette)(THIS_ LPDIRECTDRAWPALETTE *lplpDDPalette) PURE; \
1750     STDMETHOD(GetPixelFormat)(THIS_ LPDDPIXELFORMAT lpDDPixelFormat) PURE; \
1751     STDMETHOD(GetSurfaceDesc)(THIS_ LPDDSURFACEDESC lpDDSurfaceDesc) PURE; \
1752     STDMETHOD(Initialize)(THIS_ LPDIRECTDRAW lpDD, LPDDSURFACEDESC lpDDSurfaceDesc) PURE; \
1753     STDMETHOD(IsLost)(THIS) PURE; \
1754     STDMETHOD(Lock)(THIS_ LPRECT lpDestRect, LPDDSURFACEDESC lpDDSurfaceDesc, DWORD dwFlags, HANDLE hEvent) PURE; \
1755     STDMETHOD(ReleaseDC)(THIS_ HDC hDC) PURE; \
1756     STDMETHOD(Restore)(THIS) PURE; \
1757     STDMETHOD(SetClipper)(THIS_ LPDIRECTDRAWCLIPPER lpDDClipper) PURE; \
1758     STDMETHOD(SetColorKey)(THIS_ DWORD dwFlags, LPDDCOLORKEY lpDDColorKey) PURE; \
1759     STDMETHOD(SetOverlayPosition)(THIS_ LONG lX, LONG lY) PURE; \
1760     STDMETHOD(SetPalette)(THIS_ LPDIRECTDRAWPALETTE lpDDPalette) PURE; \
1761     STDMETHOD(Unlock)(THIS_ LPVOID lpSurfaceData) PURE; \
1762     STDMETHOD(UpdateOverlay)(THIS_ LPRECT lpSrcRect, LPDIRECTDRAWSURFACE3 lpDDDestSurface, LPRECT lpDestRect, DWORD dwFlags, LPDDOVERLAYFX lpDDOverlayFx) PURE; \
1763     STDMETHOD(UpdateOverlayDisplay)(THIS_ DWORD dwFlags) PURE; \
1764     STDMETHOD(UpdateOverlayZOrder)(THIS_ DWORD dwFlags, LPDIRECTDRAWSURFACE3 lpDDSReference) PURE; \
1765     /* added in v2 */ \
1766     STDMETHOD(GetDDInterface)(THIS_ LPVOID *lplpDD) PURE; \
1767     STDMETHOD(PageLock)(THIS_ DWORD dwFlags) PURE; \
1768     STDMETHOD(PageUnlock)(THIS_ DWORD dwFlags) PURE; \
1769     /* added in v3 */ \
1770     STDMETHOD(SetSurfaceDesc)(THIS_ LPDDSURFACEDESC lpDDSD, DWORD dwFlags) PURE;
1771 ICOM_DEFINE(IDirectDrawSurface3,IUnknown)
1772 #undef INTERFACE
1773
1774 #ifdef COBJMACROS
1775     /*** IUnknown methods ***/
1776 #define IDirectDrawSurface3_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
1777 #define IDirectDrawSurface3_AddRef(p)             (p)->lpVtbl->AddRef(p)
1778 #define IDirectDrawSurface3_Release(p)            (p)->lpVtbl->Release(p)
1779 /*** IDirectDrawSurface methods (almost) ***/
1780 #define IDirectDrawSurface3_AddAttachedSurface(p,a)      (p)->lpVtbl->AddAttachedSurface(p,a)
1781 #define IDirectDrawSurface3_AddOverlayDirtyRect(p,a)     (p)->lpVtbl->AddOverlayDirtyRect(p,a)
1782 #define IDirectDrawSurface3_Blt(p,a,b,c,d,e)             (p)->lpVtbl->Blt(p,a,b,c,d,e)
1783 #define IDirectDrawSurface3_BltBatch(p,a,b,c)            (p)->lpVtbl->BltBatch(p,a,b,c)
1784 #define IDirectDrawSurface3_BltFast(p,a,b,c,d,e)         (p)->lpVtbl->BltFast(p,a,b,c,d,e)
1785 #define IDirectDrawSurface3_DeleteAttachedSurface(p,a,b) (p)->lpVtbl->DeleteAttachedSurface(p,a,b)
1786 #define IDirectDrawSurface3_EnumAttachedSurfaces(p,a,b)  (p)->lpVtbl->EnumAttachedSurfaces(p,a,b)
1787 #define IDirectDrawSurface3_EnumOverlayZOrders(p,a,b,c)  (p)->lpVtbl->EnumOverlayZOrders(p,a,b,c)
1788 #define IDirectDrawSurface3_Flip(p,a,b)                  (p)->lpVtbl->Flip(p,a,b)
1789 #define IDirectDrawSurface3_GetAttachedSurface(p,a,b)    (p)->lpVtbl->GetAttachedSurface(p,a,b)
1790 #define IDirectDrawSurface3_GetBltStatus(p,a)            (p)->lpVtbl->GetBltStatus(p,a)
1791 #define IDirectDrawSurface3_GetCaps(p,a)                 (p)->lpVtbl->GetCaps(p,a)
1792 #define IDirectDrawSurface3_GetClipper(p,a)              (p)->lpVtbl->GetClipper(p,a)
1793 #define IDirectDrawSurface3_GetColorKey(p,a,b)           (p)->lpVtbl->GetColorKey(p,a,b)
1794 #define IDirectDrawSurface3_GetDC(p,a)                   (p)->lpVtbl->GetDC(p,a)
1795 #define IDirectDrawSurface3_GetFlipStatus(p,a)           (p)->lpVtbl->GetFlipStatus(p,a)
1796 #define IDirectDrawSurface3_GetOverlayPosition(p,a,b)    (p)->lpVtbl->GetOverlayPosition(p,a,b)
1797 #define IDirectDrawSurface3_GetPalette(p,a)              (p)->lpVtbl->GetPalette(p,a)
1798 #define IDirectDrawSurface3_GetPixelFormat(p,a)          (p)->lpVtbl->GetPixelFormat(p,a)
1799 #define IDirectDrawSurface3_GetSurfaceDesc(p,a)          (p)->lpVtbl->GetSurfaceDesc(p,a)
1800 #define IDirectDrawSurface3_Initialize(p,a,b)            (p)->lpVtbl->Initialize(p,a,b)
1801 #define IDirectDrawSurface3_IsLost(p)                    (p)->lpVtbl->IsLost(p)
1802 #define IDirectDrawSurface3_Lock(p,a,b,c,d)              (p)->lpVtbl->Lock(p,a,b,c,d)
1803 #define IDirectDrawSurface3_ReleaseDC(p,a)               (p)->lpVtbl->ReleaseDC(p,a)
1804 #define IDirectDrawSurface3_Restore(p)                   (p)->lpVtbl->Restore(p)
1805 #define IDirectDrawSurface3_SetClipper(p,a)              (p)->lpVtbl->SetClipper(p,a)
1806 #define IDirectDrawSurface3_SetColorKey(p,a,b)           (p)->lpVtbl->SetColorKey(p,a,b)
1807 #define IDirectDrawSurface3_SetOverlayPosition(p,a,b)    (p)->lpVtbl->SetOverlayPosition(p,a,b)
1808 #define IDirectDrawSurface3_SetPalette(p,a)              (p)->lpVtbl->SetPalette(p,a)
1809 #define IDirectDrawSurface3_Unlock(p,a)                  (p)->lpVtbl->Unlock(p,a)
1810 #define IDirectDrawSurface3_UpdateOverlay(p,a,b,c,d,e)   (p)->lpVtbl->UpdateOverlay(p,a,b,c,d,e)
1811 #define IDirectDrawSurface3_UpdateOverlayDisplay(p,a)    (p)->lpVtbl->UpdateOverlayDisplay(p,a)
1812 #define IDirectDrawSurface3_UpdateOverlayZOrder(p,a,b)   (p)->lpVtbl->UpdateOverlayZOrder(p,a,b)
1813 /*** IDirectDrawSurface2 methods ***/
1814 #define IDirectDrawSurface3_GetDDInterface(p,a) (p)->lpVtbl->GetDDInterface(p,a)
1815 #define IDirectDrawSurface3_PageLock(p,a)       (p)->lpVtbl->PageLock(p,a)
1816 #define IDirectDrawSurface3_PageUnlock(p,a)     (p)->lpVtbl->PageUnlock(p,a)
1817 /*** IDirectDrawSurface3 methods ***/
1818 #define IDirectDrawSurface3_SetSurfaceDesc(p,a,b) (p)->lpVtbl->SetSurfaceDesc(p,a,b)
1819 #endif
1820
1821
1822 /*****************************************************************************
1823  * IDirectDrawSurface4 interface
1824  */
1825 /* Cannot inherit from IDirectDrawSurface2 because DDSCAPS changed to DDSCAPS2.
1826  */
1827 #define INTERFACE IDirectDrawSurface4
1828 #define IDirectDrawSurface4_METHODS \
1829     IUnknown_METHODS \
1830     STDMETHOD(AddAttachedSurface)(THIS_ LPDIRECTDRAWSURFACE4 lpDDSAttachedSurface) PURE; \
1831     STDMETHOD(AddOverlayDirtyRect)(THIS_ LPRECT lpRect) PURE; \
1832     STDMETHOD(Blt)(THIS_ LPRECT lpDestRect, LPDIRECTDRAWSURFACE4 lpDDSrcSurface, LPRECT lpSrcRect, DWORD dwFlags, LPDDBLTFX lpDDBltFx) PURE; \
1833     STDMETHOD(BltBatch)(THIS_ LPDDBLTBATCH lpDDBltBatch, DWORD dwCount, DWORD dwFlags) PURE; \
1834     STDMETHOD(BltFast)(THIS_ DWORD dwX, DWORD dwY, LPDIRECTDRAWSURFACE4 lpDDSrcSurface, LPRECT lpSrcRect, DWORD dwTrans) PURE; \
1835     STDMETHOD(DeleteAttachedSurface)(THIS_ DWORD dwFlags, LPDIRECTDRAWSURFACE4 lpDDSAttachedSurface) PURE; \
1836     STDMETHOD(EnumAttachedSurfaces)(THIS_ LPVOID lpContext, LPDDENUMSURFACESCALLBACK lpEnumSurfacesCallback) PURE; \
1837     STDMETHOD(EnumOverlayZOrders)(THIS_ DWORD dwFlags, LPVOID lpContext, LPDDENUMSURFACESCALLBACK lpfnCallback) PURE; \
1838     STDMETHOD(Flip)(THIS_ LPDIRECTDRAWSURFACE4 lpDDSurfaceTargetOverride, DWORD dwFlags) PURE; \
1839     STDMETHOD(GetAttachedSurface)(THIS_ LPDDSCAPS2 lpDDSCaps, LPDIRECTDRAWSURFACE4 *lplpDDAttachedSurface) PURE; \
1840     STDMETHOD(GetBltStatus)(THIS_ DWORD dwFlags) PURE; \
1841     STDMETHOD(GetCaps)(THIS_ LPDDSCAPS2 lpDDSCaps) PURE; \
1842     STDMETHOD(GetClipper)(THIS_ LPDIRECTDRAWCLIPPER *lplpDDClipper) PURE; \
1843     STDMETHOD(GetColorKey)(THIS_ DWORD dwFlags, LPDDCOLORKEY lpDDColorKey) PURE; \
1844     STDMETHOD(GetDC)(THIS_ HDC *lphDC) PURE; \
1845     STDMETHOD(GetFlipStatus)(THIS_ DWORD dwFlags) PURE; \
1846     STDMETHOD(GetOverlayPosition)(THIS_ LPLONG lplX, LPLONG lplY) PURE; \
1847     STDMETHOD(GetPalette)(THIS_ LPDIRECTDRAWPALETTE *lplpDDPalette) PURE; \
1848     STDMETHOD(GetPixelFormat)(THIS_ LPDDPIXELFORMAT lpDDPixelFormat) PURE; \
1849     STDMETHOD(GetSurfaceDesc)(THIS_ LPDDSURFACEDESC2 lpDDSurfaceDesc) PURE; \
1850     STDMETHOD(Initialize)(THIS_ LPDIRECTDRAW lpDD, LPDDSURFACEDESC2 lpDDSurfaceDesc) PURE; \
1851     STDMETHOD(IsLost)(THIS) PURE; \
1852     STDMETHOD(Lock)(THIS_ LPRECT lpDestRect, LPDDSURFACEDESC2 lpDDSurfaceDesc, DWORD dwFlags, HANDLE hEvent) PURE; \
1853     STDMETHOD(ReleaseDC)(THIS_ HDC hDC) PURE; \
1854     STDMETHOD(Restore)(THIS) PURE; \
1855     STDMETHOD(SetClipper)(THIS_ LPDIRECTDRAWCLIPPER lpDDClipper) PURE; \
1856     STDMETHOD(SetColorKey)(THIS_ DWORD dwFlags, LPDDCOLORKEY lpDDColorKey) PURE; \
1857     STDMETHOD(SetOverlayPosition)(THIS_ LONG lX, LONG lY) PURE; \
1858     STDMETHOD(SetPalette)(THIS_ LPDIRECTDRAWPALETTE lpDDPalette) PURE; \
1859     STDMETHOD(Unlock)(THIS_ LPRECT lpSurfaceData) PURE; \
1860     STDMETHOD(UpdateOverlay)(THIS_ LPRECT lpSrcRect, LPDIRECTDRAWSURFACE4 lpDDDestSurface, LPRECT lpDestRect, DWORD dwFlags, LPDDOVERLAYFX lpDDOverlayFx) PURE; \
1861     STDMETHOD(UpdateOverlayDisplay)(THIS_ DWORD dwFlags) PURE; \
1862     STDMETHOD(UpdateOverlayZOrder)(THIS_ DWORD dwFlags, LPDIRECTDRAWSURFACE4 lpDDSReference) PURE; \
1863     /* added in v2 */ \
1864     STDMETHOD(GetDDInterface)(THIS_ LPVOID *lplpDD) PURE; \
1865     STDMETHOD(PageLock)(THIS_ DWORD dwFlags) PURE; \
1866     STDMETHOD(PageUnlock)(THIS_ DWORD dwFlags) PURE; \
1867     /* added in v3 */ \
1868     STDMETHOD(SetSurfaceDesc)(THIS_ LPDDSURFACEDESC2 lpDDSD, DWORD dwFlags) PURE; \
1869     /* added in v4 */ \
1870     STDMETHOD(SetPrivateData)(THIS_ REFGUID tag, LPVOID pData, DWORD cbSize, DWORD dwFlags) PURE; \
1871     STDMETHOD(GetPrivateData)(THIS_ REFGUID tag, LPVOID pBuffer, LPDWORD pcbBufferSize) PURE; \
1872     STDMETHOD(FreePrivateData)(THIS_ REFGUID tag) PURE; \
1873     STDMETHOD(GetUniquenessValue)(THIS_ LPDWORD pValue) PURE; \
1874     STDMETHOD(ChangeUniquenessValue)(THIS) PURE;
1875 ICOM_DEFINE(IDirectDrawSurface4,IUnknown)
1876 #undef INTERFACE
1877
1878 #ifdef COBJMACROS
1879     /*** IUnknown methods ***/
1880 #define IDirectDrawSurface4_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
1881 #define IDirectDrawSurface4_AddRef(p)             (p)->lpVtbl->AddRef(p)
1882 #define IDirectDrawSurface4_Release(p)            (p)->lpVtbl->Release(p)
1883 /*** IDirectDrawSurface (almost) methods ***/
1884 #define IDirectDrawSurface4_AddAttachedSurface(p,a)      (p)->lpVtbl->AddAttachedSurface(p,a)
1885 #define IDirectDrawSurface4_AddOverlayDirtyRect(p,a)     (p)->lpVtbl->AddOverlayDirtyRect(p,a)
1886 #define IDirectDrawSurface4_Blt(p,a,b,c,d,e)             (p)->lpVtbl->Blt(p,a,b,c,d,e)
1887 #define IDirectDrawSurface4_BltBatch(p,a,b,c)            (p)->lpVtbl->BltBatch(p,a,b,c)
1888 #define IDirectDrawSurface4_BltFast(p,a,b,c,d,e)         (p)->lpVtbl->BltFast(p,a,b,c,d,e)
1889 #define IDirectDrawSurface4_DeleteAttachedSurface(p,a,b) (p)->lpVtbl->DeleteAttachedSurface(p,a,b)
1890 #define IDirectDrawSurface4_EnumAttachedSurfaces(p,a,b)  (p)->lpVtbl->EnumAttachedSurfaces(p,a,b)
1891 #define IDirectDrawSurface4_EnumOverlayZOrders(p,a,b,c)  (p)->lpVtbl->EnumOverlayZOrders(p,a,b,c)
1892 #define IDirectDrawSurface4_Flip(p,a,b)                  (p)->lpVtbl->Flip(p,a,b)
1893 #define IDirectDrawSurface4_GetAttachedSurface(p,a,b)    (p)->lpVtbl->GetAttachedSurface(p,a,b)
1894 #define IDirectDrawSurface4_GetBltStatus(p,a)            (p)->lpVtbl->GetBltStatus(p,a)
1895 #define IDirectDrawSurface4_GetCaps(p,a)                 (p)->lpVtbl->GetCaps(p,a)
1896 #define IDirectDrawSurface4_GetClipper(p,a)              (p)->lpVtbl->GetClipper(p,a)
1897 #define IDirectDrawSurface4_GetColorKey(p,a,b)           (p)->lpVtbl->GetColorKey(p,a,b)
1898 #define IDirectDrawSurface4_GetDC(p,a)                   (p)->lpVtbl->GetDC(p,a)
1899 #define IDirectDrawSurface4_GetFlipStatus(p,a)           (p)->lpVtbl->GetFlipStatus(p,a)
1900 #define IDirectDrawSurface4_GetOverlayPosition(p,a,b)    (p)->lpVtbl->GetOverlayPosition(p,a,b)
1901 #define IDirectDrawSurface4_GetPalette(p,a)              (p)->lpVtbl->GetPalette(p,a)
1902 #define IDirectDrawSurface4_GetPixelFormat(p,a)          (p)->lpVtbl->GetPixelFormat(p,a)
1903 #define IDirectDrawSurface4_GetSurfaceDesc(p,a)          (p)->lpVtbl->GetSurfaceDesc(p,a)
1904 #define IDirectDrawSurface4_Initialize(p,a,b)            (p)->lpVtbl->Initialize(p,a,b)
1905 #define IDirectDrawSurface4_IsLost(p)                    (p)->lpVtbl->IsLost(p)
1906 #define IDirectDrawSurface4_Lock(p,a,b,c,d)              (p)->lpVtbl->Lock(p,a,b,c,d)
1907 #define IDirectDrawSurface4_ReleaseDC(p,a)               (p)->lpVtbl->ReleaseDC(p,a)
1908 #define IDirectDrawSurface4_Restore(p)                   (p)->lpVtbl->Restore(p)
1909 #define IDirectDrawSurface4_SetClipper(p,a)              (p)->lpVtbl->SetClipper(p,a)
1910 #define IDirectDrawSurface4_SetColorKey(p,a,b)           (p)->lpVtbl->SetColorKey(p,a,b)
1911 #define IDirectDrawSurface4_SetOverlayPosition(p,a,b)    (p)->lpVtbl->SetOverlayPosition(p,a,b)
1912 #define IDirectDrawSurface4_SetPalette(p,a)              (p)->lpVtbl->SetPalette(p,a)
1913 #define IDirectDrawSurface4_Unlock(p,a)                  (p)->lpVtbl->Unlock(p,a)
1914 #define IDirectDrawSurface4_UpdateOverlay(p,a,b,c,d,e)   (p)->lpVtbl->UpdateOverlay(p,a,b,c,d,e)
1915 #define IDirectDrawSurface4_UpdateOverlayDisplay(p,a)    (p)->lpVtbl->UpdateOverlayDisplay(p,a)
1916 #define IDirectDrawSurface4_UpdateOverlayZOrder(p,a,b)   (p)->lpVtbl->UpdateOverlayZOrder(p,a,b)
1917 /*** IDirectDrawSurface2 methods ***/
1918 #define IDirectDrawSurface4_GetDDInterface(p,a) (p)->lpVtbl->GetDDInterface(p,a)
1919 #define IDirectDrawSurface4_PageLock(p,a)       (p)->lpVtbl->PageLock(p,a)
1920 #define IDirectDrawSurface4_PageUnlock(p,a)     (p)->lpVtbl->PageUnlock(p,a)
1921 /*** IDirectDrawSurface3 methods ***/
1922 #define IDirectDrawSurface4_SetSurfaceDesc(p,a,b) (p)->lpVtbl->SetSurfaceDesc(p,a,b)
1923 /*** IDirectDrawSurface4 methods ***/
1924 #define IDirectDrawSurface4_SetPrivateData(p,a,b,c,d) (p)->lpVtbl->SetPrivateData(p,a,b,c,d)
1925 #define IDirectDrawSurface4_GetPrivateData(p,a,b,c)   (p)->lpVtbl->GetPrivateData(p,a,b,c)
1926 #define IDirectDrawSurface4_FreePrivateData(p,a)      (p)->lpVtbl->FreePrivateData(p,a)
1927 #define IDirectDrawSurface4_GetUniquenessValue(p,a)   (p)->lpVtbl->GetUniquenessValue(p,a)
1928 #define IDirectDrawSurface4_ChangeUniquenessValue(p)  (p)->lpVtbl->ChangeUniquenessValue(p)
1929 #endif
1930
1931
1932 /*****************************************************************************
1933  * IDirectDrawSurface7 interface
1934  */
1935 #define INTERFACE IDirectDrawSurface7
1936 #define IDirectDrawSurface7_METHODS \
1937     IUnknown_METHODS \
1938     STDMETHOD(AddAttachedSurface)(THIS_ LPDIRECTDRAWSURFACE7 lpDDSAttachedSurface) PURE; \
1939     STDMETHOD(AddOverlayDirtyRect)(THIS_ LPRECT lpRect) PURE; \
1940     STDMETHOD(Blt)(THIS_ LPRECT lpDestRect, LPDIRECTDRAWSURFACE7 lpDDSrcSurface, LPRECT lpSrcRect, DWORD dwFlags, LPDDBLTFX lpDDBltFx) PURE; \
1941     STDMETHOD(BltBatch)(THIS_ LPDDBLTBATCH lpDDBltBatch, DWORD dwCount, DWORD dwFlags) PURE; \
1942     STDMETHOD(BltFast)(THIS_ DWORD dwX, DWORD dwY, LPDIRECTDRAWSURFACE7 lpDDSrcSurface, LPRECT lpSrcRect, DWORD dwTrans) PURE; \
1943     STDMETHOD(DeleteAttachedSurface)(THIS_ DWORD dwFlags, LPDIRECTDRAWSURFACE7 lpDDSAttachedSurface) PURE; \
1944     STDMETHOD(EnumAttachedSurfaces)(THIS_ LPVOID lpContext, LPDDENUMSURFACESCALLBACK7 lpEnumSurfacesCallback) PURE; \
1945     STDMETHOD(EnumOverlayZOrders)(THIS_ DWORD dwFlags, LPVOID lpContext, LPDDENUMSURFACESCALLBACK7 lpfnCallback) PURE; \
1946     STDMETHOD(Flip)(THIS_ LPDIRECTDRAWSURFACE7 lpDDSurfaceTargetOverride, DWORD dwFlags) PURE; \
1947     STDMETHOD(GetAttachedSurface)(THIS_ LPDDSCAPS2 lpDDSCaps, LPDIRECTDRAWSURFACE7 *lplpDDAttachedSurface) PURE; \
1948     STDMETHOD(GetBltStatus)(THIS_ DWORD dwFlags) PURE; \
1949     STDMETHOD(GetCaps)(THIS_ LPDDSCAPS2 lpDDSCaps) PURE; \
1950     STDMETHOD(GetClipper)(THIS_ LPDIRECTDRAWCLIPPER *lplpDDClipper) PURE; \
1951     STDMETHOD(GetColorKey)(THIS_ DWORD dwFlags, LPDDCOLORKEY lpDDColorKey) PURE; \
1952     STDMETHOD(GetDC)(THIS_ HDC *lphDC) PURE; \
1953     STDMETHOD(GetFlipStatus)(THIS_ DWORD dwFlags) PURE; \
1954     STDMETHOD(GetOverlayPosition)(THIS_ LPLONG lplX, LPLONG lplY) PURE; \
1955     STDMETHOD(GetPalette)(THIS_ LPDIRECTDRAWPALETTE *lplpDDPalette) PURE; \
1956     STDMETHOD(GetPixelFormat)(THIS_ LPDDPIXELFORMAT lpDDPixelFormat) PURE; \
1957     STDMETHOD(GetSurfaceDesc)(THIS_ LPDDSURFACEDESC2 lpDDSurfaceDesc) PURE; \
1958     STDMETHOD(Initialize)(THIS_ LPDIRECTDRAW lpDD, LPDDSURFACEDESC2 lpDDSurfaceDesc) PURE; \
1959     STDMETHOD(IsLost)(THIS) PURE; \
1960     STDMETHOD(Lock)(THIS_ LPRECT lpDestRect, LPDDSURFACEDESC2 lpDDSurfaceDesc, DWORD dwFlags, HANDLE hEvent) PURE; \
1961     STDMETHOD(ReleaseDC)(THIS_ HDC hDC) PURE; \
1962     STDMETHOD(Restore)(THIS) PURE; \
1963     STDMETHOD(SetClipper)(THIS_ LPDIRECTDRAWCLIPPER lpDDClipper) PURE; \
1964     STDMETHOD(SetColorKey)(THIS_ DWORD dwFlags, LPDDCOLORKEY lpDDColorKey) PURE; \
1965     STDMETHOD(SetOverlayPosition)(THIS_ LONG lX, LONG lY) PURE; \
1966     STDMETHOD(SetPalette)(THIS_ LPDIRECTDRAWPALETTE lpDDPalette) PURE; \
1967     STDMETHOD(Unlock)(THIS_ LPRECT lpSurfaceData) PURE; \
1968     STDMETHOD(UpdateOverlay)(THIS_ LPRECT lpSrcRect, LPDIRECTDRAWSURFACE7 lpDDDestSurface, LPRECT lpDestRect, DWORD dwFlags, LPDDOVERLAYFX lpDDOverlayFx) PURE; \
1969     STDMETHOD(UpdateOverlayDisplay)(THIS_ DWORD dwFlags) PURE; \
1970     STDMETHOD(UpdateOverlayZOrder)(THIS_ DWORD dwFlags, LPDIRECTDRAWSURFACE7 lpDDSReference) PURE; \
1971     /* added in v2 */ \
1972     STDMETHOD(GetDDInterface)(THIS_ LPVOID *lplpDD) PURE; \
1973     STDMETHOD(PageLock)(THIS_ DWORD dwFlags) PURE; \
1974     STDMETHOD(PageUnlock)(THIS_ DWORD dwFlags) PURE; \
1975     /* added in v3 */ \
1976     STDMETHOD(SetSurfaceDesc)(THIS_ LPDDSURFACEDESC2 lpDDSD, DWORD dwFlags) PURE; \
1977     /* added in v4 */ \
1978     STDMETHOD(SetPrivateData)(THIS_ REFGUID tag, LPVOID pData, DWORD cbSize, DWORD dwFlags) PURE; \
1979     STDMETHOD(GetPrivateData)(THIS_ REFGUID tag, LPVOID pBuffer, LPDWORD pcbBufferSize) PURE; \
1980     STDMETHOD(FreePrivateData)(THIS_ REFGUID tag) PURE; \
1981     STDMETHOD(GetUniquenessValue)(THIS_ LPDWORD pValue) PURE; \
1982     STDMETHOD(ChangeUniquenessValue)(THIS) PURE; \
1983     /* added in v7 */ \
1984     STDMETHOD(SetPriority)(THIS_ DWORD prio) PURE; \
1985     STDMETHOD(GetPriority)(THIS_ LPDWORD prio) PURE; \
1986     STDMETHOD(SetLOD)(THIS_ DWORD lod) PURE; \
1987     STDMETHOD(GetLOD)(THIS_ LPDWORD lod) PURE;
1988 ICOM_DEFINE(IDirectDrawSurface7,IUnknown)
1989 #undef INTERFACE
1990
1991 #ifdef COBJMACROS
1992     /*** IUnknown methods ***/
1993 #define IDirectDrawSurface7_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
1994 #define IDirectDrawSurface7_AddRef(p)             (p)->lpVtbl->AddRef(p)
1995 #define IDirectDrawSurface7_Release(p)            (p)->lpVtbl->Release(p)
1996 /*** IDirectDrawSurface (almost) methods ***/
1997 #define IDirectDrawSurface7_AddAttachedSurface(p,a)      (p)->lpVtbl->AddAttachedSurface(p,a)
1998 #define IDirectDrawSurface7_AddOverlayDirtyRect(p,a)     (p)->lpVtbl->AddOverlayDirtyRect(p,a)
1999 #define IDirectDrawSurface7_Blt(p,a,b,c,d,e)             (p)->lpVtbl->Blt(p,a,b,c,d,e)
2000 #define IDirectDrawSurface7_BltBatch(p,a,b,c)            (p)->lpVtbl->BltBatch(p,a,b,c)
2001 #define IDirectDrawSurface7_BltFast(p,a,b,c,d,e)         (p)->lpVtbl->BltFast(p,a,b,c,d,e)
2002 #define IDirectDrawSurface7_DeleteAttachedSurface(p,a,b) (p)->lpVtbl->DeleteAttachedSurface(p,a,b)
2003 #define IDirectDrawSurface7_EnumAttachedSurfaces(p,a,b)  (p)->lpVtbl->EnumAttachedSurfaces(p,a,b)
2004 #define IDirectDrawSurface7_EnumOverlayZOrders(p,a,b,c)  (p)->lpVtbl->EnumOverlayZOrders(p,a,b,c)
2005 #define IDirectDrawSurface7_Flip(p,a,b)                  (p)->lpVtbl->Flip(p,a,b)
2006 #define IDirectDrawSurface7_GetAttachedSurface(p,a,b)    (p)->lpVtbl->GetAttachedSurface(p,a,b)
2007 #define IDirectDrawSurface7_GetBltStatus(p,a)            (p)->lpVtbl->GetBltStatus(p,a)
2008 #define IDirectDrawSurface7_GetCaps(p,a)                 (p)->lpVtbl->GetCaps(p,a)
2009 #define IDirectDrawSurface7_GetClipper(p,a)              (p)->lpVtbl->GetClipper(p,a)
2010 #define IDirectDrawSurface7_GetColorKey(p,a,b)           (p)->lpVtbl->GetColorKey(p,a,b)
2011 #define IDirectDrawSurface7_GetDC(p,a)                   (p)->lpVtbl->GetDC(p,a)
2012 #define IDirectDrawSurface7_GetFlipStatus(p,a)           (p)->lpVtbl->GetFlipStatus(p,a)
2013 #define IDirectDrawSurface7_GetOverlayPosition(p,a,b)    (p)->lpVtbl->GetOverlayPosition(p,a,b)
2014 #define IDirectDrawSurface7_GetPalette(p,a)              (p)->lpVtbl->GetPalette(p,a)
2015 #define IDirectDrawSurface7_GetPixelFormat(p,a)          (p)->lpVtbl->GetPixelFormat(p,a)
2016 #define IDirectDrawSurface7_GetSurfaceDesc(p,a)          (p)->lpVtbl->GetSurfaceDesc(p,a)
2017 #define IDirectDrawSurface7_Initialize(p,a,b)            (p)->lpVtbl->Initialize(p,a,b)
2018 #define IDirectDrawSurface7_IsLost(p)                    (p)->lpVtbl->IsLost(p)
2019 #define IDirectDrawSurface7_Lock(p,a,b,c,d)              (p)->lpVtbl->Lock(p,a,b,c,d)
2020 #define IDirectDrawSurface7_ReleaseDC(p,a)               (p)->lpVtbl->ReleaseDC(p,a)
2021 #define IDirectDrawSurface7_Restore(p)                   (p)->lpVtbl->Restore(p)
2022 #define IDirectDrawSurface7_SetClipper(p,a)              (p)->lpVtbl->SetClipper(p,a)
2023 #define IDirectDrawSurface7_SetColorKey(p,a,b)           (p)->lpVtbl->SetColorKey(p,a,b)
2024 #define IDirectDrawSurface7_SetOverlayPosition(p,a,b)    (p)->lpVtbl->SetOverlayPosition(p,a,b)
2025 #define IDirectDrawSurface7_SetPalette(p,a)              (p)->lpVtbl->SetPalette(p,a)
2026 #define IDirectDrawSurface7_Unlock(p,a)                  (p)->lpVtbl->Unlock(p,a)
2027 #define IDirectDrawSurface7_UpdateOverlay(p,a,b,c,d,e)   (p)->lpVtbl->UpdateOverlay(p,a,b,c,d,e)
2028 #define IDirectDrawSurface7_UpdateOverlayDisplay(p,a)    (p)->lpVtbl->UpdateOverlayDisplay(p,a)
2029 #define IDirectDrawSurface7_UpdateOverlayZOrder(p,a,b)   (p)->lpVtbl->UpdateOverlayZOrder(p,a,b)
2030 /*** IDirectDrawSurface2 methods ***/
2031 #define IDirectDrawSurface7_GetDDInterface(p,a) (p)->lpVtbl->GetDDInterface(p,a)
2032 #define IDirectDrawSurface7_PageLock(p,a)       (p)->lpVtbl->PageLock(p,a)
2033 #define IDirectDrawSurface7_PageUnlock(p,a)     (p)->lpVtbl->PageUnlock(p,a)
2034 /*** IDirectDrawSurface3 methods ***/
2035 #define IDirectDrawSurface7_SetSurfaceDesc(p,a,b) (p)->lpVtbl->SetSurfaceDesc(p,a,b)
2036 /*** IDirectDrawSurface4 methods ***/
2037 #define IDirectDrawSurface7_SetPrivateData(p,a,b,c,d) (p)->lpVtbl->SetPrivateData(p,a,b,c,d)
2038 #define IDirectDrawSurface7_GetPrivateData(p,a,b,c)   (p)->lpVtbl->GetPrivateData(p,a,b,c)
2039 #define IDirectDrawSurface7_FreePrivateData(p,a)      (p)->lpVtbl->FreePrivateData(p,a)
2040 #define IDirectDrawSurface7_GetUniquenessValue(p,a)   (p)->lpVtbl->GetUniquenessValue(p,a)
2041 #define IDirectDrawSurface7_ChangeUniquenessValue(p)  (p)->lpVtbl->ChangeUniquenessValue(p)
2042 /*** IDirectDrawSurface7 methods ***/
2043 #define IDirectDrawSurface7_SetPriority(p,a)          (p)->lpVtbl->SetPriority(p,a)
2044 #define IDirectDrawSurface7_GetPriority(p,a)          (p)->lpVtbl->GetPriority(p,a)
2045 #define IDirectDrawSurface7_SetLOD(p,a)               (p)->lpVtbl->SetLOD(p,a)
2046 #define IDirectDrawSurface7_GetLOD(p,a)               (p)->lpVtbl->GetLOD(p,a)
2047 #endif
2048
2049 /*****************************************************************************
2050  * IDirectDrawColorControl interface
2051  */
2052 #define INTERFACE IDirectDrawColorControl
2053 #define IDirectDrawColorControl_METHODS \
2054     IUnknown_METHODS \
2055     STDMETHOD(GetColorControls)(THIS_ LPDDCOLORCONTROL lpColorControl) PURE; \
2056     STDMETHOD(SetColorControls)(THIS_ LPDDCOLORCONTROL lpColorControl) PURE;
2057 ICOM_DEFINE(IDirectDrawColorControl,IUnknown)
2058 #undef INTERFACE
2059
2060 #ifdef COBJMACROS
2061         /*** IUnknown methods ***/
2062 #define IDirectDrawColorControl_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
2063 #define IDirectDrawColorControl_AddRef(p)             (p)->lpVtbl->AddRef(p)
2064 #define IDirectDrawColorControl_Release(p)            (p)->lpVtbl->Release(p)
2065         /*** IDirectDrawColorControl methods ***/
2066 #define IDirectDrawColorControl_GetColorControls(p,a) (p)->lpVtbl->GetColorControls(p,a)
2067 #define IDirectDrawColorControl_SetColorControls(p,a) (p)->lpVtbl->SetColorControls(p,a)
2068 #endif
2069
2070 /*****************************************************************************
2071  * IDirectDrawGammaControl interface
2072  */
2073 #define INTERFACE IDirectDrawGammaControl
2074 #define IDirectDrawGammaControl_METHODS \
2075     IUnknown_METHODS \
2076     STDMETHOD(GetGammaRamp)(THIS_ DWORD dwFlags, LPDDGAMMARAMP lpGammaRamp) PURE; \
2077     STDMETHOD(SetGammaRamp)(THIS_ DWORD dwFlags, LPDDGAMMARAMP lpGammaRamp) PURE;
2078 ICOM_DEFINE(IDirectDrawGammaControl,IUnknown)
2079 #undef INTERFACE
2080
2081 #ifdef COBJMACROS
2082         /*** IUnknown methods ***/
2083 #define IDirectDrawGammaControl_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
2084 #define IDirectDrawGammaControl_AddRef(p)             (p)->lpVtbl->AddRef(p)
2085 #define IDirectDrawGammaControl_Release(p)            (p)->lpVtbl->Release(p)
2086         /*** IDirectDrawGammaControl methods ***/
2087 #define IDirectDrawGammaControl_GetGammaRamp(p,a,b)   (p)->lpVtbl->GetGammaRamp(p,a,b)
2088 #define IDirectDrawGammaControl_SetGammaRamp(p,a,b)   (p)->lpVtbl->SetGammaRamp(p,a,b)
2089 #endif
2090
2091
2092 HRESULT WINAPI DirectDrawCreate(LPGUID,LPDIRECTDRAW*,LPUNKNOWN);
2093 HRESULT WINAPI DirectDrawCreateEx(LPGUID,LPVOID*,REFIID,LPUNKNOWN);
2094 HRESULT WINAPI DirectDrawEnumerateA(LPDDENUMCALLBACKA,LPVOID);
2095 HRESULT WINAPI DirectDrawEnumerateW(LPDDENUMCALLBACKW,LPVOID);
2096 #define DirectDrawEnumerate WINELIB_NAME_AW(DirectDrawEnumerate)
2097 HRESULT WINAPI DirectDrawCreateClipper(DWORD,LPDIRECTDRAWCLIPPER*,LPUNKNOWN);
2098
2099 #ifdef __cplusplus
2100 } /* extern "C" */
2101 #endif /* defined(__cplusplus) */
2102
2103 #endif /* __WINE_DDRAW_H */