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