1 |
//*********************************************************************
|
2 |
//* Microsoft Windows **
|
3 |
//* Copyright(c) Microsoft Corp., 1995-1997 **
|
4 |
//*********************************************************************
|
5 |
//
|
6 |
// DDRAWEX.H
|
7 |
//
|
8 |
// Header file for DirectDrawEx functionality
|
9 |
|
10 |
#ifndef __DDRAWEXH__
|
11 |
#define __DDRAWEXH__
|
12 |
|
13 |
#ifdef __cplusplus
|
14 |
extern "C" {
|
15 |
#endif
|
16 |
|
17 |
#include <ddraw.h>
|
18 |
|
19 |
// {4FD2A832-86C8-11d0-8FCA-00C04FD9189D}
|
20 |
DEFINE_GUID(CLSID_DirectDrawFactory,
|
21 |
0x4fd2a832, 0x86c8, 0x11d0, 0x8f, 0xca, 0x0, 0xc0, 0x4f, 0xd9, 0x18, 0x9d);
|
22 |
|
23 |
DEFINE_GUID(IID_IDirectDrawFactory,
|
24 |
0x4fd2a833, 0x86c8, 0x11d0, 0x8f, 0xca, 0x0, 0xc0, 0x4f, 0xd9, 0x18, 0x9d);
|
25 |
|
26 |
#ifndef DIRECTDRAW_VERSION
|
27 |
|
28 |
//Functionality supported by DDrawex but not DX3
|
29 |
#define DDSD_LPSURFACE 0x00000800l
|
30 |
|
31 |
DEFINE_GUID( IID_IDirectDrawSurface3,
|
32 |
0xDA044E00,0x69B2,0x11D0,0xA1,0xD5,0x00,0xAA,0x00,0xB8,0xDF,0xBB );
|
33 |
|
34 |
typedef struct IDirectDrawSurface3 FAR *LPDIRECTDRAWSURFACE3;
|
35 |
|
36 |
#undef INTERFACE
|
37 |
#define INTERFACE IDirectDrawSurface3
|
38 |
DECLARE_INTERFACE_( IDirectDrawSurface3, IUnknown )
|
39 |
{
|
40 |
/*** IUnknown methods ***/
|
41 |
STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE;
|
42 |
STDMETHOD_(ULONG,AddRef) (THIS) PURE;
|
43 |
STDMETHOD_(ULONG,Release) (THIS) PURE;
|
44 |
/*** IDirectDrawSurface methods ***/
|
45 |
STDMETHOD(AddAttachedSurface)(THIS_ LPDIRECTDRAWSURFACE3) PURE;
|
46 |
STDMETHOD(AddOverlayDirtyRect)(THIS_ LPRECT) PURE;
|
47 |
STDMETHOD(Blt)(THIS_ LPRECT,LPDIRECTDRAWSURFACE3, LPRECT,DWORD, LPDDBLTFX) PURE;
|
48 |
STDMETHOD(BltBatch)(THIS_ LPDDBLTBATCH, DWORD, DWORD ) PURE;
|
49 |
STDMETHOD(BltFast)(THIS_ DWORD,DWORD,LPDIRECTDRAWSURFACE3, LPRECT,DWORD) PURE;
|
50 |
STDMETHOD(DeleteAttachedSurface)(THIS_ DWORD,LPDIRECTDRAWSURFACE3) PURE;
|
51 |
STDMETHOD(EnumAttachedSurfaces)(THIS_ LPVOID,LPDDENUMSURFACESCALLBACK) PURE;
|
52 |
STDMETHOD(EnumOverlayZOrders)(THIS_ DWORD,LPVOID,LPDDENUMSURFACESCALLBACK) PURE;
|
53 |
STDMETHOD(Flip)(THIS_ LPDIRECTDRAWSURFACE3, DWORD) PURE;
|
54 |
STDMETHOD(GetAttachedSurface)(THIS_ LPDDSCAPS, LPDIRECTDRAWSURFACE3 FAR *) PURE;
|
55 |
STDMETHOD(GetBltStatus)(THIS_ DWORD) PURE;
|
56 |
STDMETHOD(GetCaps)(THIS_ LPDDSCAPS) PURE;
|
57 |
STDMETHOD(GetClipper)(THIS_ LPDIRECTDRAWCLIPPER FAR*) PURE;
|
58 |
STDMETHOD(GetColorKey)(THIS_ DWORD, LPDDCOLORKEY) PURE;
|
59 |
STDMETHOD(GetDC)(THIS_ HDC FAR *) PURE;
|
60 |
STDMETHOD(GetFlipStatus)(THIS_ DWORD) PURE;
|
61 |
STDMETHOD(GetOverlayPosition)(THIS_ LPLONG, LPLONG ) PURE;
|
62 |
STDMETHOD(GetPalette)(THIS_ LPDIRECTDRAWPALETTE FAR*) PURE;
|
63 |
STDMETHOD(GetPixelFormat)(THIS_ LPDDPIXELFORMAT) PURE;
|
64 |
STDMETHOD(GetSurfaceDesc)(THIS_ LPDDSURFACEDESC) PURE;
|
65 |
STDMETHOD(Initialize)(THIS_ LPDIRECTDRAW, LPDDSURFACEDESC) PURE;
|
66 |
STDMETHOD(IsLost)(THIS) PURE;
|
67 |
STDMETHOD(Lock)(THIS_ LPRECT,LPDDSURFACEDESC,DWORD,HANDLE) PURE;
|
68 |
STDMETHOD(ReleaseDC)(THIS_ HDC) PURE;
|
69 |
STDMETHOD(Restore)(THIS) PURE;
|
70 |
STDMETHOD(SetClipper)(THIS_ LPDIRECTDRAWCLIPPER) PURE;
|
71 |
STDMETHOD(SetColorKey)(THIS_ DWORD, LPDDCOLORKEY) PURE;
|
72 |
STDMETHOD(SetOverlayPosition)(THIS_ LONG, LONG ) PURE;
|
73 |
STDMETHOD(SetPalette)(THIS_ LPDIRECTDRAWPALETTE) PURE;
|
74 |
STDMETHOD(Unlock)(THIS_ LPVOID) PURE;
|
75 |
STDMETHOD(UpdateOverlay)(THIS_ LPRECT, LPDIRECTDRAWSURFACE3,LPRECT,DWORD, LPDDOVERLAYFX) PURE;
|
76 |
STDMETHOD(UpdateOverlayDisplay)(THIS_ DWORD) PURE;
|
77 |
STDMETHOD(UpdateOverlayZOrder)(THIS_ DWORD, LPDIRECTDRAWSURFACE3) PURE;
|
78 |
/*** Added in the v2 interface ***/
|
79 |
STDMETHOD(GetDDInterface)(THIS_ LPVOID FAR *) PURE;
|
80 |
STDMETHOD(PageLock)(THIS_ DWORD) PURE;
|
81 |
STDMETHOD(PageUnlock)(THIS_ DWORD) PURE;
|
82 |
/*** Added in the v3 interface ***/
|
83 |
STDMETHOD(SetSurfaceDesc)(THIS_ LPDDSURFACEDESC, DWORD ) PURE;
|
84 |
};
|
85 |
#endif
|
86 |
|
87 |
|
88 |
|
89 |
|
90 |
#define DDSCAPS_DATAEXCHANGE (DDSCAPS_SYSTEMMEMORY|DDSCAPS_VIDEOMEMORY)
|
91 |
|
92 |
#undef INTERFACE
|
93 |
#define INTERFACE IDirectDrawFactory
|
94 |
|
95 |
DECLARE_INTERFACE_(IDirectDrawFactory, IUnknown)
|
96 |
{
|
97 |
/*** IUnknown methods ***/
|
98 |
STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE;
|
99 |
STDMETHOD_(ULONG,AddRef) (THIS) PURE;
|
100 |
STDMETHOD_(ULONG,Release) (THIS) PURE;
|
101 |
/*** IDirectDrawFactory methods ***/
|
102 |
STDMETHOD(CreateDirectDraw) (THIS_ GUID * pGUID, HWND hWnd, DWORD dwCoopLevelFlags, DWORD dwReserved, IUnknown *pUnkOuter, IDirectDraw **ppDirectDraw) PURE;
|
103 |
STDMETHOD(DirectDrawEnumerate) (THIS_ LPDDENUMCALLBACK lpCallback, LPVOID lpContext) PURE;
|
104 |
};
|
105 |
|
106 |
|
107 |
|
108 |
// {618F8AD4-8B7A-11d0-8FCC-00C04FD9189D}
|
109 |
DEFINE_GUID(IID_IDirectDraw3,
|
110 |
0x618f8ad4, 0x8b7a, 0x11d0, 0x8f, 0xcc, 0x0, 0xc0, 0x4f, 0xd9, 0x18, 0x9d);
|
111 |
|
112 |
typedef struct IDirectDraw3 FAR *LPDIRECTDRAW3;
|
113 |
|
114 |
#undef INTERFACE
|
115 |
#define INTERFACE IDirectDraw3
|
116 |
|
117 |
DECLARE_INTERFACE_(IDirectDraw3, IUnknown)
|
118 |
{
|
119 |
/*** IUnknown methods ***/
|
120 |
STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE;
|
121 |
STDMETHOD_(ULONG,AddRef) (THIS) PURE;
|
122 |
STDMETHOD_(ULONG,Release) (THIS) PURE;
|
123 |
/*** IDirectDraw methods ***/
|
124 |
STDMETHOD(Compact)(THIS) PURE;
|
125 |
STDMETHOD(CreateClipper)(THIS_ DWORD, LPDIRECTDRAWCLIPPER FAR*, IUnknown FAR * ) PURE;
|
126 |
STDMETHOD(CreatePalette)(THIS_ DWORD, LPPALETTEENTRY, LPDIRECTDRAWPALETTE FAR*, IUnknown FAR * ) PURE;
|
127 |
STDMETHOD(CreateSurface)(THIS_ LPDDSURFACEDESC, LPDIRECTDRAWSURFACE FAR *, IUnknown FAR *) PURE;
|
128 |
STDMETHOD(DuplicateSurface)( THIS_ LPDIRECTDRAWSURFACE, LPDIRECTDRAWSURFACE FAR * ) PURE;
|
129 |
STDMETHOD(EnumDisplayModes)( THIS_ DWORD, LPDDSURFACEDESC, LPVOID, LPDDENUMMODESCALLBACK ) PURE;
|
130 |
STDMETHOD(EnumSurfaces)(THIS_ DWORD, LPDDSURFACEDESC, LPVOID,LPDDENUMSURFACESCALLBACK ) PURE;
|
131 |
STDMETHOD(FlipToGDISurface)(THIS) PURE;
|
132 |
STDMETHOD(GetCaps)( THIS_ LPDDCAPS, LPDDCAPS) PURE;
|
133 |
STDMETHOD(GetDisplayMode)( THIS_ LPDDSURFACEDESC) PURE;
|
134 |
STDMETHOD(GetFourCCCodes)(THIS_ LPDWORD, LPDWORD ) PURE;
|
135 |
STDMETHOD(GetGDISurface)(THIS_ LPDIRECTDRAWSURFACE FAR *) PURE;
|
136 |
STDMETHOD(GetMonitorFrequency)(THIS_ LPDWORD) PURE;
|
137 |
STDMETHOD(GetScanLine)(THIS_ LPDWORD) PURE;
|
138 |
STDMETHOD(GetVerticalBlankStatus)(THIS_ LPBOOL ) PURE;
|
139 |
STDMETHOD(Initialize)(THIS_ GUID FAR *) PURE;
|
140 |
STDMETHOD(RestoreDisplayMode)(THIS) PURE;
|
141 |
STDMETHOD(SetCooperativeLevel)(THIS_ HWND, DWORD) PURE;
|
142 |
STDMETHOD(SetDisplayMode)(THIS_ DWORD, DWORD,DWORD, DWORD, DWORD) PURE;
|
143 |
STDMETHOD(WaitForVerticalBlank)(THIS_ DWORD, HANDLE ) PURE;
|
144 |
/*** Added in the v2 interface ***/
|
145 |
STDMETHOD(GetAvailableVidMem)(THIS_ LPDDSCAPS, LPDWORD, LPDWORD) PURE;
|
146 |
/*** IDirectDraw3 methods ***/
|
147 |
STDMETHOD(GetSurfaceFromDC) (THIS_ HDC, IDirectDrawSurface **) PURE;
|
148 |
};
|
149 |
|
150 |
#if !defined(__cplusplus) || defined(CINTERFACE)
|
151 |
#define IDirectDraw3_QueryInterface(p, a, b) (p)->lpVtbl->QueryInterface(p, a, b)
|
152 |
#define IDirectDraw3_AddRef(p) (p)->lpVtbl->AddRef(p)
|
153 |
#define IDirectDraw3_Release(p) (p)->lpVtbl->Release(p)
|
154 |
#define IDirectDraw3_Compact(p) (p)->lpVtbl->Compact(p)
|
155 |
#define IDirectDraw3_CreateClipper(p, a, b, c) (p)->lpVtbl->CreateClipper(p, a, b, c)
|
156 |
#define IDirectDraw3_CreatePalette(p, a, b, c, d) (p)->lpVtbl->CreatePalette(p, a, b, c, d)
|
157 |
#define IDirectDraw3_CreateSurface(p, a, b, c) (p)->lpVtbl->CreateSurface(p, a, b, c)
|
158 |
#define IDirectDraw3_DuplicateSurface(p, a, b) (p)->lpVtbl->DuplicateSurface(p, a, b)
|
159 |
#define IDirectDraw3_EnumDisplayModes(p, a, b, c, d) (p)->lpVtbl->EnumDisplayModes(p, a, b, c, d)
|
160 |
#define IDirectDraw3_EnumSurfaces(p, a, b, c, d) (p)->lpVtbl->EnumSurfaces(p, a, b, c, d)
|
161 |
#define IDirectDraw3_FlipToGDISurface(p) (p)->lpVtbl->FlipToGDISurface(p)
|
162 |
#define IDirectDraw3_GetCaps(p, a, b) (p)->lpVtbl->GetCaps(p, a, b)
|
163 |
#define IDirectDraw3_GetDisplayMode(p, a) (p)->lpVtbl->GetDisplayMode(p, a)
|
164 |
#define IDirectDraw3_GetFourCCCodes(p, a, b) (p)->lpVtbl->GetFourCCCodes(p, a, b)
|
165 |
#define IDirectDraw3_GetGDISurface(p, a) (p)->lpVtbl->GetGDISurface(p, a)
|
166 |
#define IDirectDraw3_GetMonitorFrequency(p, a) (p)->lpVtbl->GetMonitorFrequency(p, a)
|
167 |
#define IDirectDraw3_GetScanLine(p, a) (p)->lpVtbl->GetScanLine(p, a)
|
168 |
#define IDirectDraw3_GetVerticalBlankStatus(p, a) (p)->lpVtbl->GetVerticalBlankStatus(p, a)
|
169 |
#define IDirectDraw3_Initialize(p, a) (p)->lpVtbl->Initialize(p, a)
|
170 |
#define IDirectDraw3_RestoreDisplayMode(p) (p)->lpVtbl->RestoreDisplayMode(p)
|
171 |
#define IDirectDraw3_SetCooperativeLevel(p, a, b) (p)->lpVtbl->SetCooperativeLevel(p, a, b)
|
172 |
#define IDirectDraw3_SetDisplayMode(p, a, b, c, d, e) (p)->lpVtbl->SetDisplayMode(p, a, b, c, d, e)
|
173 |
#define IDirectDraw3_WaitForVerticalBlank(p, a, b) (p)->lpVtbl->WaitForVerticalBlank(p, a, b)
|
174 |
#define IDirectDraw3_GetAvailableVidMem(p, a, b, c) (p)->lpVtbl->GetAvailableVidMem(p, a, b, c)
|
175 |
#define IDirectDraw3_GetSurfaceFromDC(p, a, b) (p)->lpVtbl->GetSurfaceFromDC(p, a, b)
|
176 |
#endif
|
177 |
|
178 |
|
179 |
|
180 |
/*===========================================================================
|
181 |
*
|
182 |
*
|
183 |
* DIRECTDRAWEX RETURN CODES
|
184 |
*
|
185 |
* The return values from DirectDrawEx Commands and Surface that return an
|
186 |
* HRESULT are codes from DirectDrawEx concerning the results of the action
|
187 |
* requested by DirectDrawEx.
|
188 |
*
|
189 |
*==========================================================================*/
|
190 |
|
191 |
/*
|
192 |
* An attempt was made to load ddraw.dll
|
193 |
*/
|
194 |
#define DDERR_LOADFAILED MAKE_DDHRESULT( 901 )
|
195 |
|
196 |
/*
|
197 |
* Unable to determine module/os version number
|
198 |
*/
|
199 |
#define DDERR_BADVERSIONINFO MAKE_DDHRESULT( 902 )
|
200 |
|
201 |
/*
|
202 |
* Unable to determine address of ddraw.dll exported symbol (DirectDrawCreate or
|
203 |
* DirectDrawEnumerate).
|
204 |
*/
|
205 |
#define DDERR_BADPROCADDRESS MAKE_DDHRESULT( 903 )
|
206 |
|
207 |
/*
|
208 |
* Legacy usage: do not use QI() to create D3D device objects from surface objects.
|
209 |
* Use IDirect3D2::CreateDevice()
|
210 |
*/
|
211 |
#define DDERR_LEGACYUSAGE MAKE_DDHRESULT( 904 )
|
212 |
|
213 |
#ifdef __cplusplus
|
214 |
}
|
215 |
#endif
|
216 |
|
217 |
|
218 |
#endif // __DDRAWEXH__
|