git.oblomov.eu Git - wine/blob - dlls/ddraw/ddraw.c

   1 /*
   2  * Copyright 1997-2000 Marcus Meissner
   3  * Copyright 1998-2000 Lionel Ulmer
   4  * Copyright 2000-2001 TransGaming Technologies Inc.
   5  * Copyright 2006 Stefan Dösinger
   6  *
   7  * This library is free software; you can redistribute it and/or
   8  * modify it under the terms of the GNU Lesser General Public
   9  * License as published by the Free Software Foundation; either
  10  * version 2.1 of the License, or (at your option) any later version.
  11  *
  12  * This library is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  * Lesser General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU Lesser General Public
  18  * License along with this library; if not, write to the Free Software
  19  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  20  */
  21
  22 #include "config.h"
  23 #include "wine/port.h"
  24
  25 #include <assert.h>
  26 #include <stdarg.h>
  27 #include <string.h>
  28 #include <stdlib.h>
  29
  30 #define COBJMACROS
  31 #define NONAMELESSUNION
  32
  33 #include "windef.h"
  34 #include "winbase.h"
  35 #include "winerror.h"
  36 #include "wingdi.h"
  37 #include "wine/exception.h"
  38
  39 #include "ddraw.h"
  40 #include "d3d.h"
  41
  42 #include "ddraw_private.h"
  43 #include "wine/debug.h"
  44
  45 WINE_DEFAULT_DEBUG_CHANNEL(ddraw);
  46
  47 static BOOL IDirectDrawImpl_DDSD_Match(const DDSURFACEDESC2* requested, const DDSURFACEDESC2* provided);
  48 static HRESULT WINAPI IDirectDrawImpl_AttachD3DDevice(IDirectDrawImpl *This, IDirectDrawSurfaceImpl *primary);
  49 static HRESULT WINAPI IDirectDrawImpl_CreateNewSurface(IDirectDrawImpl *This, DDSURFACEDESC2 *pDDSD, IDirectDrawSurfaceImpl **ppSurf, UINT level);
  50
  51 /* Device identifier. Don't relay it to WineD3D */
  52 static const DDDEVICEIDENTIFIER2 deviceidentifier =
  53 {
  54     "display",
  55     "DirectDraw HAL",
  56     { { 0x00010001, 0x00010001 } },
  57     0, 0, 0, 0,
  58     /* a8373c10-7ac4-4deb-849a-009844d08b2d */
  59     {0xa8373c10,0x7ac4,0x4deb, {0x84,0x9a,0x00,0x98,0x44,0xd0,0x8b,0x2d}},
  60     0
  61 };
  62
  63 /*****************************************************************************
  64  * IUnknown Methods
  65  *****************************************************************************/
  66
  67 /*****************************************************************************
  68  * IDirectDraw7::QueryInterface
  69  *
  70  * Queries different interfaces of the DirectDraw object. It can return
  71  * IDirectDraw interfaces in version 1, 2, 4 and 7, and IDirect3D interfaces
  72  * in version 1, 2, 3 and 7. An IDirect3DDevice can be created with this
  73  * method.
  74  * The returned interface is AddRef()-ed before it's returned
  75  *
  76  * Rules for QueryInterface:
  77  *  http://msdn.microsoft.com/library/default.asp? \
  78  *    url=/library/en-us/com/html/6db17ed8-06e4-4bae-bc26-113176cc7e0e.asp
  79  *
  80  * Used for version 1, 2, 4 and 7
  81  *
  82  * Params:
  83  *  refiid: Interface ID asked for
  84  *  obj: Used to return the interface pointer
  85  *
  86  * Returns:
  87  *  S_OK if an interface was found
  88  *  E_NOINTERFACE if the requested interface wasn't found
  89  *
  90  *****************************************************************************/
  91 static HRESULT WINAPI
  92 IDirectDrawImpl_QueryInterface(IDirectDraw7 *iface,
  93                                REFIID refiid,
  94                                void **obj)
  95 {
  96     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
  97
  98     TRACE("(%p)->(%s,%p)\n", This, debugstr_guid(refiid), obj);
  99
 100     /* Can change surface impl type */
 101     EnterCriticalSection(&ddraw_cs);
 102
 103     /* According to COM docs, if the QueryInterface fails, obj should be set to NULL */
 104     *obj = NULL;
 105
 106     if(!refiid)
 107     {
 108         LeaveCriticalSection(&ddraw_cs);
 109         return DDERR_INVALIDPARAMS;
 110     }
 111
 112     /* Check DirectDraw Interfaces */
 113     if ( IsEqualGUID( &IID_IUnknown, refiid ) ||
 114          IsEqualGUID( &IID_IDirectDraw7, refiid ) )
 115     {
 116         *obj = ICOM_INTERFACE(This, IDirectDraw7);
 117         TRACE("(%p) Returning IDirectDraw7 interface at %p\n", This, *obj);
 118     }
 119     else if ( IsEqualGUID( &IID_IDirectDraw4, refiid ) )
 120     {
 121         *obj = ICOM_INTERFACE(This, IDirectDraw4);
 122         TRACE("(%p) Returning IDirectDraw4 interface at %p\n", This, *obj);
 123     }
 124     else if ( IsEqualGUID( &IID_IDirectDraw3, refiid ) )
 125     {
 126         *obj = ICOM_INTERFACE(This, IDirectDraw3);
 127         TRACE("(%p) Returning IDirectDraw3 interface at %p\n", This, *obj);
 128     }
 129     else if ( IsEqualGUID( &IID_IDirectDraw2, refiid ) )
 130     {
 131         *obj = ICOM_INTERFACE(This, IDirectDraw2);
 132         TRACE("(%p) Returning IDirectDraw2 interface at %p\n", This, *obj);
 133     }
 134     else if ( IsEqualGUID( &IID_IDirectDraw, refiid ) )
 135     {
 136         *obj = ICOM_INTERFACE(This, IDirectDraw);
 137         TRACE("(%p) Returning IDirectDraw interface at %p\n", This, *obj);
 138     }
 139
 140     /* Direct3D
 141      * The refcount unit test revealed that an IDirect3D7 interface can only be queried
 142      * from a DirectDraw object that was created as an IDirectDraw7 interface. No idea
 143      * who had this idea and why. The older interfaces can query and IDirect3D version
 144      * because they are all created as IDirectDraw(1). This isn't really crucial behavior,
 145      * and messy to implement with the common creation function, so it has been left out here.
 146      */
 147     else if ( IsEqualGUID( &IID_IDirect3D  , refiid ) ||
 148               IsEqualGUID( &IID_IDirect3D2 , refiid ) ||
 149               IsEqualGUID( &IID_IDirect3D3 , refiid ) ||
 150               IsEqualGUID( &IID_IDirect3D7 , refiid ) )
 151     {
 152         /* Check the surface implementation */
 153         if(This->ImplType == SURFACE_UNKNOWN)
 154         {
 155             /* Apps may create the IDirect3D Interface before the primary surface.
 156              * set the surface implementation */
 157             This->ImplType = SURFACE_OPENGL;
 158             TRACE("(%p) Choosing OpenGL surfaces because a Direct3D interface was requested\n", This);
 159         }
 160         else if(This->ImplType != SURFACE_OPENGL && DefaultSurfaceType == SURFACE_UNKNOWN)
 161         {
 162             ERR("(%p) The App is requesting a D3D device, but a non-OpenGL surface type was choosen. Prepare for trouble!\n", This);
 163             ERR(" (%p) You may want to contact wine-devel for help\n", This);
 164             /* Should I assert(0) here??? */
 165         }
 166         else if(This->ImplType != SURFACE_OPENGL)
 167         {
 168             WARN("The app requests a Direct3D interface, but non-opengl surfaces where set in winecfg\n");
 169             /* Do not abort here, only reject 3D Device creation */
 170         }
 171
 172         if ( IsEqualGUID( &IID_IDirect3D  , refiid ) )
 173         {
 174             This->d3dversion = 1;
 175             *obj = ICOM_INTERFACE(This, IDirect3D);
 176             TRACE(" returning Direct3D interface at %p.\n", *obj);
 177         }
 178         else if ( IsEqualGUID( &IID_IDirect3D2  , refiid ) )
 179         {
 180             This->d3dversion = 2;
 181             *obj = ICOM_INTERFACE(This, IDirect3D2);
 182             TRACE(" returning Direct3D2 interface at %p.\n", *obj);
 183         }
 184         else if ( IsEqualGUID( &IID_IDirect3D3  , refiid ) )
 185         {
 186             This->d3dversion = 3;
 187             *obj = ICOM_INTERFACE(This, IDirect3D3);
 188             TRACE(" returning Direct3D3 interface at %p.\n", *obj);
 189         }
 190         else if(IsEqualGUID( &IID_IDirect3D7  , refiid ))
 191         {
 192             This->d3dversion = 7;
 193             *obj = ICOM_INTERFACE(This, IDirect3D7);
 194             TRACE(" returning Direct3D7 interface at %p.\n", *obj);
 195         }
 196     }
 197
 198     /* Unknown interface */
 199     else
 200     {
 201         ERR("(%p)->(%s, %p): No interface found\n", This, debugstr_guid(refiid), obj);
 202         LeaveCriticalSection(&ddraw_cs);
 203         return E_NOINTERFACE;
 204     }
 205
 206     IUnknown_AddRef( (IUnknown *) *obj );
 207     LeaveCriticalSection(&ddraw_cs);
 208     return S_OK;
 209 }
 210
 211 /*****************************************************************************
 212  * IDirectDraw7::AddRef
 213  *
 214  * Increases the interfaces refcount, basically
 215  *
 216  * DDraw refcounting is a bit tricky. The different DirectDraw interface
 217  * versions have individual refcounts, but the IDirect3D interfaces do not.
 218  * All interfaces are from one object, that means calling QueryInterface on an
 219  * IDirectDraw7 interface for an IDirectDraw4 interface does not create a new
 220  * IDirectDrawImpl object.
 221  *
 222  * That means all AddRef and Release implementations of IDirectDrawX work
 223  * with their own counter, and IDirect3DX::AddRef thunk to IDirectDraw (1),
 224  * except of IDirect3D7 which thunks to IDirectDraw7
 225  *
 226  * Returns: The new refcount
 227  *
 228  *****************************************************************************/
 229 static ULONG WINAPI
 230 IDirectDrawImpl_AddRef(IDirectDraw7 *iface)
 231 {
 232     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
 233     ULONG ref = InterlockedIncrement(&This->ref7);
 234
 235     TRACE("(%p) : incrementing IDirectDraw7 refcount from %u.\n", This, ref -1);
 236
 237     if(ref == 1) InterlockedIncrement(&This->numIfaces);
 238
 239     return ref;
 240 }
 241
 242 /*****************************************************************************
 243  * IDirectDrawImpl_Destroy
 244  *
 245  * Destroys a ddraw object if all refcounts are 0. This is to share code
 246  * between the IDirectDrawX::Release functions
 247  *
 248  * Params:
 249  *  This: DirectDraw object to destroy
 250  *
 251  *****************************************************************************/
 252 void
 253 IDirectDrawImpl_Destroy(IDirectDrawImpl *This)
 254 {
 255     /* Clear the cooplevel to restore window and display mode */
 256     IDirectDraw7_SetCooperativeLevel(ICOM_INTERFACE(This, IDirectDraw7),
 257                                         NULL,
 258                                         DDSCL_NORMAL);
 259
 260     /* Destroy the device window if we created one */
 261     if(This->devicewindow != 0)
 262     {
 263         TRACE(" (%p) Destroying the device window %p\n", This, This->devicewindow);
 264         DestroyWindow(This->devicewindow);
 265         This->devicewindow = 0;
 266     }
 267
 268     /* Unregister the window class */
 269     UnregisterClassA(This->classname, 0);
 270
 271     EnterCriticalSection(&ddraw_cs);
 272     list_remove(&This->ddraw_list_entry);
 273     LeaveCriticalSection(&ddraw_cs);
 274
 275     /* Release the attached WineD3D stuff */
 276     IWineD3DDevice_Release(This->wineD3DDevice);
 277     IWineD3D_Release(This->wineD3D);
 278
 279     /* Now free the object */
 280     HeapFree(GetProcessHeap(), 0, This);
 281 }
 282
 283 /*****************************************************************************
 284  * IDirectDraw7::Release
 285  *
 286  * Decreases the refcount. If the refcount falls to 0, the object is destroyed
 287  *
 288  * Returns: The new refcount
 289  *****************************************************************************/
 290 static ULONG WINAPI
 291 IDirectDrawImpl_Release(IDirectDraw7 *iface)
 292 {
 293     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
 294     ULONG ref = InterlockedDecrement(&This->ref7);
 295
 296     TRACE("(%p)->() decrementing IDirectDraw7 refcount from %u.\n", This, ref +1);
 297
 298     if(ref == 0)
 299     {
 300         ULONG ifacecount = InterlockedDecrement(&This->numIfaces);
 301         if(ifacecount == 0) IDirectDrawImpl_Destroy(This);
 302     }
 303
 304     return ref;
 305 }
 306
 307 /*****************************************************************************
 308  * IDirectDraw methods
 309  *****************************************************************************/
 310
 311 /*****************************************************************************
 312  * IDirectDraw7::SetCooperativeLevel
 313  *
 314  * Sets the cooperative level for the DirectDraw object, and the window
 315  * assigned to it. The cooperative level determines the general behavior
 316  * of the DirectDraw application
 317  *
 318  * Warning: This is quite tricky, as it's not really documented which
 319  * cooperative levels can be combined with each other. If a game fails
 320  * after this function, try to check the cooperative levels passed on
 321  * Windows, and if it returns something different.
 322  *
 323  * If you think that this function caused the failure because it writes a
 324  * fixme, be sure to run again with a +ddraw trace.
 325  *
 326  * What is known about cooperative levels (See the ddraw modes test):
 327  * DDSCL_EXCLUSIVE and DDSCL_FULLSCREEN must be used with each other
 328  * DDSCL_NORMAL is not compatible with DDSCL_EXCLUSIVE or DDSCL_FULLSCREEN
 329  * DDSCL_SETFOCUSWINDOW can be passed only in DDSCL_NORMAL mode, but after that
 330  * DDSCL_FULLSCREEN can be activated
 331  * DDSCL_SETFOCUSWINDOW may only be used with DDSCL_NOWINDOWCHANGES
 332  *
 333  * Handled flags: DDSCL_NORMAL, DDSCL_FULLSCREEN, DDSCL_EXCLUSIVE,
 334  *                DDSCL_SETFOCUSWINDOW (partially),
 335  *                DDSCL_MULTITHREADED (work in progress)
 336  *
 337  * Unhandled flags, which should be implemented
 338  *  DDSCL_SETDEVICEWINDOW: Sets a window specially used for rendering (I don't
 339  *  expect any difference to a normal window for wine)
 340  *  DDSCL_CREATEDEVICEWINDOW: Tells ddraw to create its own window for
 341  *  rendering (Possible test case: Half-life)
 342  *
 343  * Unsure about these: DDSCL_FPUSETUP DDSCL_FPURESERVE
 344  *
 345  * These seem not really imporant for wine
 346  *  DDSCL_ALLOWREBOOT, DDSCL_NOWINDOWCHANGES, DDSCL_ALLOWMODEX
 347  *
 348  * Returns:
 349  *  DD_OK if the cooperative level was set successfully
 350  *  DDERR_INVALIDPARAMS if the passed cooperative level combination is invalid
 351  *  DDERR_HWNDALREADYSET if DDSCL_SETFOCUSWINDOW is passed in exclusive mode
 352  *   (Probably others too, have to investigate)
 353  *
 354  *****************************************************************************/
 355 static HRESULT WINAPI
 356 IDirectDrawImpl_SetCooperativeLevel(IDirectDraw7 *iface,
 357                                     HWND hwnd,
 358                                     DWORD cooplevel)
 359 {
 360     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
 361     HWND window;
 362     HRESULT hr;
 363
 364     TRACE("(%p)->(%p,%08x)\n",This,hwnd,cooplevel);
 365     DDRAW_dump_cooperativelevel(cooplevel);
 366
 367     EnterCriticalSection(&ddraw_cs);
 368
 369     /* Get the old window */
 370     hr = IWineD3DDevice_GetHWND(This->wineD3DDevice, &window);
 371     if(hr != D3D_OK)
 372     {
 373         ERR("IWineD3DDevice::GetHWND failed, hr = %08x\n", hr);
 374         LeaveCriticalSection(&ddraw_cs);
 375         return hr;
 376     }
 377
 378     /* Tests suggest that we need one of them: */
 379     if(!(cooplevel & (DDSCL_SETFOCUSWINDOW |
 380                       DDSCL_NORMAL         |
 381                       DDSCL_EXCLUSIVE      )))
 382     {
 383         TRACE("Incorrect cooplevel flags, returning DDERR_INVALIDPARAMS\n");
 384         LeaveCriticalSection(&ddraw_cs);
 385         return DDERR_INVALIDPARAMS;
 386     }
 387
 388     /* Handle those levels first which set various hwnds */
 389     if(cooplevel & DDSCL_SETFOCUSWINDOW)
 390     {
 391         /* This isn't compatible with a lot of flags */
 392         if(cooplevel & ( DDSCL_MULTITHREADED   |
 393                          DDSCL_FPUSETUP        |
 394                          DDSCL_FPUPRESERVE     |
 395                          DDSCL_ALLOWREBOOT     |
 396                          DDSCL_ALLOWMODEX      |
 397                          DDSCL_SETDEVICEWINDOW |
 398                          DDSCL_NORMAL          |
 399                          DDSCL_EXCLUSIVE       |
 400                          DDSCL_FULLSCREEN      ) )
 401         {
 402             TRACE("Called with incompatible flags, returning DDERR_INVALIDPARAMS\n");
 403             LeaveCriticalSection(&ddraw_cs);
 404             return DDERR_INVALIDPARAMS;
 405         }
 406         else if( (This->cooperative_level & DDSCL_FULLSCREEN) && window)
 407         {
 408             TRACE("Setting DDSCL_SETFOCUSWINDOW with an already set window, returning DDERR_HWNDALREADYSET\n");
 409             LeaveCriticalSection(&ddraw_cs);
 410             return DDERR_HWNDALREADYSET;
 411         }
 412
 413         This->focuswindow = hwnd;
 414         /* Won't use the hwnd param for anything else */
 415         hwnd = NULL;
 416
 417         /* Use the focus window for drawing too */
 418         IWineD3DDevice_SetHWND(This->wineD3DDevice, This->focuswindow);
 419
 420         /* Destroy the device window, if we have one */
 421         if(This->devicewindow)
 422         {
 423             DestroyWindow(This->devicewindow);
 424             This->devicewindow = NULL;
 425         }
 426     }
 427     /* DDSCL_NORMAL or DDSCL_FULLSCREEN | DDSCL_EXCLUSIVE */
 428     if(cooplevel & DDSCL_NORMAL)
 429     {
 430         /* Can't coexist with fullscreen or exclusive */
 431         if(cooplevel & (DDSCL_FULLSCREEN | DDSCL_EXCLUSIVE) )
 432         {
 433             TRACE("(%p) DDSCL_NORMAL is not compative with DDSCL_FULLSCREEN or DDSCL_EXCLUSIVE\n", This);
 434             LeaveCriticalSection(&ddraw_cs);
 435             return DDERR_INVALIDPARAMS;
 436         }
 437
 438         /* Switching from fullscreen? */
 439         if(This->cooperative_level & DDSCL_FULLSCREEN)
 440         {
 441             /* Restore the display mode */
 442             IDirectDraw7_RestoreDisplayMode(iface);
 443
 444             This->cooperative_level &= ~DDSCL_FULLSCREEN;
 445             This->cooperative_level &= ~DDSCL_EXCLUSIVE;
 446             This->cooperative_level &= ~DDSCL_ALLOWMODEX;
 447         }
 448
 449         /* Don't override focus windows or private device windows */
 450         if( hwnd &&
 451             !(This->focuswindow) &&
 452             !(This->devicewindow) &&
 453             (hwnd != window) )
 454         {
 455             IWineD3DDevice_SetHWND(This->wineD3DDevice, hwnd);
 456         }
 457
 458         IWineD3DDevice_SetFullscreen(This->wineD3DDevice,
 459                                      FALSE);
 460     }
 461     else if(cooplevel & DDSCL_FULLSCREEN)
 462     {
 463         /* Needs DDSCL_EXCLUSIVE */
 464         if(!(cooplevel & DDSCL_EXCLUSIVE) )
 465         {
 466             TRACE("(%p) DDSCL_FULLSCREEN needs DDSCL_EXCLUSIVE\n", This);
 467             LeaveCriticalSection(&ddraw_cs);
 468             return DDERR_INVALIDPARAMS;
 469         }
 470         /* Need a HWND
 471         if(hwnd == 0)
 472         {
 473             TRACE("(%p) DDSCL_FULLSCREEN needs a HWND\n", This);
 474             return DDERR_INVALIDPARAMS;
 475         }
 476         */
 477
 478         This->cooperative_level &= ~DDSCL_NORMAL;
 479         IWineD3DDevice_SetFullscreen(This->wineD3DDevice,
 480                                      TRUE);
 481
 482         /* Don't override focus windows or private device windows */
 483         if( hwnd &&
 484             !(This->focuswindow) &&
 485             !(This->devicewindow) &&
 486             (hwnd != window) )
 487         {
 488             IWineD3DDevice_SetHWND(This->wineD3DDevice, hwnd);
 489         }
 490     }
 491     else if(cooplevel & DDSCL_EXCLUSIVE)
 492     {
 493         TRACE("(%p) DDSCL_EXCLUSIVE needs DDSCL_FULLSCREEN\n", This);
 494         LeaveCriticalSection(&ddraw_cs);
 495         return DDERR_INVALIDPARAMS;
 496     }
 497
 498     if(cooplevel & DDSCL_CREATEDEVICEWINDOW)
 499     {
 500         /* Don't create a device window if a focus window is set */
 501         if( !(This->focuswindow) )
 502         {
 503             HWND devicewindow = CreateWindowExA(0, This->classname, "DDraw device window",
 504                                                 WS_POPUP, 0, 0,
 505                                                 GetSystemMetrics(SM_CXSCREEN),
 506                                                 GetSystemMetrics(SM_CYSCREEN),
 507                                                 NULL, NULL, GetModuleHandleA(0), NULL);
 508
 509             ShowWindow(devicewindow, SW_SHOW);   /* Just to be sure */
 510             TRACE("(%p) Created a DDraw device window. HWND=%p\n", This, devicewindow);
 511
 512             IWineD3DDevice_SetHWND(This->wineD3DDevice, devicewindow);
 513             This->devicewindow = devicewindow;
 514         }
 515     }
 516
 517     if(cooplevel & DDSCL_MULTITHREADED && !(This->cooperative_level & DDSCL_MULTITHREADED))
 518     {
 519         /* Enable thread safety in wined3d */
 520         IWineD3DDevice_SetMultithreaded(This->wineD3DDevice);
 521     }
 522
 523     /* Unhandled flags */
 524     if(cooplevel & DDSCL_ALLOWREBOOT)
 525         WARN("(%p) Unhandled flag DDSCL_ALLOWREBOOT, harmless\n", This);
 526     if(cooplevel & DDSCL_ALLOWMODEX)
 527         WARN("(%p) Unhandled flag DDSCL_ALLOWMODEX, harmless\n", This);
 528     if(cooplevel & DDSCL_FPUSETUP)
 529         WARN("(%p) Unhandled flag DDSCL_FPUSETUP, harmless\n", This);
 530     if(cooplevel & DDSCL_FPUPRESERVE)
 531         WARN("(%p) Unhandled flag DDSCL_FPUPRESERVE, harmless\n", This);
 532
 533     /* Store the cooperative_level */
 534     This->cooperative_level |= cooplevel;
 535     TRACE("SetCooperativeLevel retuning DD_OK\n");
 536     LeaveCriticalSection(&ddraw_cs);
 537     return DD_OK;
 538 }
 539
 540 /*****************************************************************************
 541  * IDirectDraw7::SetDisplayMode
 542  *
 543  * Sets the display screen resolution, color depth and refresh frequency
 544  * when in fullscreen mode (in theory).
 545  * Possible return values listed in the SDK suggest that this method fails
 546  * when not in fullscreen mode, but this is wrong. Windows 2000 happily sets
 547  * the display mode in DDSCL_NORMAL mode without an hwnd specified.
 548  * It seems to be valid to pass 0 for With and Height, this has to be tested
 549  * It could mean that the current video mode should be left as-is. (But why
 550  * call it then?)
 551  *
 552  * Params:
 553  *  Height, Width: Screen dimension
 554  *  BPP: Color depth in Bits per pixel
 555  *  Refreshrate: Screen refresh rate
 556  *  Flags: Other stuff
 557  *
 558  * Returns
 559  *  DD_OK on success
 560  *
 561  *****************************************************************************/
 562 static HRESULT WINAPI
 563 IDirectDrawImpl_SetDisplayMode(IDirectDraw7 *iface,
 564                                DWORD Width,
 565                                DWORD Height,
 566                                DWORD BPP,
 567                                DWORD RefreshRate,
 568                                DWORD Flags)
 569 {
 570     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
 571     WINED3DDISPLAYMODE Mode;
 572     HRESULT hr;
 573     TRACE("(%p)->(%d,%d,%d,%d,%x: Relay!\n", This, Width, Height, BPP, RefreshRate, Flags);
 574
 575     EnterCriticalSection(&ddraw_cs);
 576     if( !Width || !Height )
 577     {
 578         ERR("Width=%d, Height=%d, what to do?\n", Width, Height);
 579         /* It looks like Need for Speed Porsche Unleashed expects DD_OK here */
 580         LeaveCriticalSection(&ddraw_cs);
 581         return DD_OK;
 582     }
 583
 584     /* Check the exclusive mode
 585     if(!(This->cooperative_level & DDSCL_EXCLUSIVE))
 586         return DDERR_NOEXCLUSIVEMODE;
 587      * This is WRONG. Don't know if the SDK is completely
 588      * wrong and if there are any conditions when DDERR_NOEXCLUSIVE
 589      * is returned, but Half-Life 1.1.1.1 (Steam version)
 590      * depends on this
 591      */
 592
 593     Mode.Width = Width;
 594     Mode.Height = Height;
 595     Mode.RefreshRate = RefreshRate;
 596     switch(BPP)
 597     {
 598         case 8:  Mode.Format = WINED3DFMT_P8;       break;
 599         case 15: Mode.Format = WINED3DFMT_X1R5G5B5; break;
 600         case 16: Mode.Format = WINED3DFMT_R5G6B5;   break;
 601         case 24: Mode.Format = WINED3DFMT_R8G8B8;   break;
 602         case 32: Mode.Format = WINED3DFMT_A8R8G8B8; break;
 603     }
 604
 605     /* TODO: The possible return values from msdn suggest that
 606      * the screen mode can't be changed if a surface is locked
 607      * or some drawing is in progress
 608      */
 609
 610     /* TODO: Lose the primary surface */
 611     hr = IWineD3DDevice_SetDisplayMode(This->wineD3DDevice,
 612                                        0, /* First swapchain */
 613                                        &Mode);
 614     LeaveCriticalSection(&ddraw_cs);
 615     switch(hr)
 616     {
 617         case WINED3DERR_NOTAVAILABLE:       return DDERR_UNSUPPORTED;
 618         default:                            return hr;
 619     };
 620 }
 621
 622 /*****************************************************************************
 623  * IDirectDraw7::RestoreDisplayMode
 624  *
 625  * Restores the display mode to what it was at creation time. Basically.
 626  *
 627  * A problem arises when there are 2 DirectDraw objects using the same hwnd:
 628  *  -> DD_1 finds the screen at 1400x1050x32 when created, sets it to 640x480x16
 629  *  -> DD_2 is created, finds the screen at 640x480x16, sets it to 1024x768x32
 630  *  -> DD_1 is released. The screen should be left at 1024x768x32.
 631  *  -> DD_2 is released. The screen should be set to 1400x1050x32
 632  * This case is unhandled right now, but Empire Earth does it this way.
 633  * (But perhaps there is something in SetCooperativeLevel to prevent this)
 634  *
 635  * The msdn says that this method resets the display mode to what it was before
 636  * SetDisplayMode was called. What if SetDisplayModes is called 2 times??
 637  *
 638  * Returns
 639  *  DD_OK on success
 640  *  DDERR_NOEXCLUSIVE mode if the device isn't in fullscreen mode
 641  *
 642  *****************************************************************************/
 643 static HRESULT WINAPI
 644 IDirectDrawImpl_RestoreDisplayMode(IDirectDraw7 *iface)
 645 {
 646     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
 647     TRACE("(%p)\n", This);
 648
 649     return IDirectDraw7_SetDisplayMode(ICOM_INTERFACE(This, IDirectDraw7),
 650                                        This->orig_width,
 651                                        This->orig_height,
 652                                        This->orig_bpp,
 653                                        0,
 654                                        0);
 655 }
 656
 657 /*****************************************************************************
 658  * IDirectDraw7::GetCaps
 659  *
 660  * Returns the drives capabilities
 661  *
 662  * Used for version 1, 2, 4 and 7
 663  *
 664  * Params:
 665  *  DriverCaps: Structure to write the Hardware accelerated caps to
 666  *  HelCaps: Structure to write the emulation caps to
 667  *
 668  * Returns
 669  *  This implementation returns DD_OK only
 670  *
 671  *****************************************************************************/
 672 static HRESULT WINAPI
 673 IDirectDrawImpl_GetCaps(IDirectDraw7 *iface,
 674                         DDCAPS *DriverCaps,
 675                         DDCAPS *HELCaps)
 676 {
 677     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
 678     TRACE("(%p)->(%p,%p)\n", This, DriverCaps, HELCaps);
 679
 680     /* One structure must be != NULL */
 681     if( (!DriverCaps) && (!HELCaps) )
 682     {
 683         ERR("(%p) Invalid params to IDirectDrawImpl_GetCaps\n", This);
 684         return DDERR_INVALIDPARAMS;
 685     }
 686
 687     if(DriverCaps)
 688     {
 689         DD_STRUCT_COPY_BYSIZE(DriverCaps, &This->caps);
 690         if (TRACE_ON(ddraw))
 691         {
 692             TRACE("Driver Caps :\n");
 693             DDRAW_dump_DDCAPS(DriverCaps);
 694         }
 695
 696     }
 697     if(HELCaps)
 698     {
 699         DD_STRUCT_COPY_BYSIZE(HELCaps, &This->caps);
 700         if (TRACE_ON(ddraw))
 701         {
 702             TRACE("HEL Caps :\n");
 703             DDRAW_dump_DDCAPS(HELCaps);
 704         }
 705     }
 706
 707     return DD_OK;
 708 }
 709
 710 /*****************************************************************************
 711  * IDirectDraw7::Compact
 712  *
 713  * No idea what it does, MSDN says it's not implemented.
 714  *
 715  * Returns
 716  *  DD_OK, but this is unchecked
 717  *
 718  *****************************************************************************/
 719 static HRESULT WINAPI
 720 IDirectDrawImpl_Compact(IDirectDraw7 *iface)
 721 {
 722     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
 723     TRACE("(%p)\n", This);
 724
 725     return DD_OK;
 726 }
 727
 728 /*****************************************************************************
 729  * IDirectDraw7::GetDisplayMode
 730  *
 731  * Returns information about the current display mode
 732  *
 733  * Exists in Version 1, 2, 4 and 7
 734  *
 735  * Params:
 736  *  DDSD: Address of a surface description structure to write the info to
 737  *
 738  * Returns
 739  *  DD_OK
 740  *
 741  *****************************************************************************/
 742 static HRESULT WINAPI
 743 IDirectDrawImpl_GetDisplayMode(IDirectDraw7 *iface,
 744                                DDSURFACEDESC2 *DDSD)
 745 {
 746     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
 747     HRESULT hr;
 748     WINED3DDISPLAYMODE Mode;
 749     DWORD Size;
 750     TRACE("(%p)->(%p): Relay\n", This, DDSD);
 751
 752     EnterCriticalSection(&ddraw_cs);
 753     /* This seems sane */
 754     if(!DDSD)
 755     {
 756         LeaveCriticalSection(&ddraw_cs);
 757         return DDERR_INVALIDPARAMS;
 758     }
 759
 760     /* The necessary members of LPDDSURFACEDESC and LPDDSURFACEDESC2 are equal,
 761      * so one method can be used for all versions (Hopefully)
 762      */
 763     hr = IWineD3DDevice_GetDisplayMode(This->wineD3DDevice,
 764                                       0 /* swapchain 0 */,
 765                                       &Mode);
 766     if( hr != D3D_OK )
 767     {
 768         ERR(" (%p) IWineD3DDevice::GetDisplayMode returned %08x\n", This, hr);
 769         LeaveCriticalSection(&ddraw_cs);
 770         return hr;
 771     }
 772
 773     Size = DDSD->dwSize;
 774     memset(DDSD, 0, Size);
 775
 776     DDSD->dwSize = Size;
 777     DDSD->dwFlags |= DDSD_HEIGHT | DDSD_WIDTH | DDSD_PIXELFORMAT | DDSD_PITCH | DDSD_REFRESHRATE;
 778     DDSD->dwWidth = Mode.Width;
 779     DDSD->dwHeight = Mode.Height;
 780     DDSD->u2.dwRefreshRate = 60;
 781     DDSD->ddsCaps.dwCaps = 0;
 782     DDSD->u4.ddpfPixelFormat.dwSize = sizeof(DDSD->u4.ddpfPixelFormat);
 783     PixelFormat_WineD3DtoDD(&DDSD->u4.ddpfPixelFormat, Mode.Format);
 784     DDSD->u1.lPitch = Mode.Width * DDSD->u4.ddpfPixelFormat.u1.dwRGBBitCount / 8;
 785
 786     if(TRACE_ON(ddraw))
 787     {
 788         TRACE("Returning surface desc :\n");
 789         DDRAW_dump_surface_desc(DDSD);
 790     }
 791
 792     LeaveCriticalSection(&ddraw_cs);
 793     return DD_OK;
 794 }
 795
 796 /*****************************************************************************
 797  * IDirectDraw7::GetFourCCCodes
 798  *
 799  * Returns an array of supported FourCC codes.
 800  *
 801  * Exists in Version 1, 2, 4 and 7
 802  *
 803  * Params:
 804  *  NumCodes: Contains the number of Codes that Codes can carry. Returns the number
 805  *            of enumerated codes
 806  *  Codes: Pointer to an array of DWORDs where the supported codes are written
 807  *         to
 808  *
 809  * Returns
 810  *  Always returns DD_OK, as it's a stub for now
 811  *
 812  *****************************************************************************/
 813 static HRESULT WINAPI
 814 IDirectDrawImpl_GetFourCCCodes(IDirectDraw7 *iface,
 815                                DWORD *NumCodes, DWORD *Codes)
 816 {
 817     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
 818     FIXME("(%p)->(%p, %p): Stub!\n", This, NumCodes, Codes);
 819
 820     if(NumCodes) *NumCodes = 0;
 821
 822     return DD_OK;
 823 }
 824
 825 /*****************************************************************************
 826  * IDirectDraw7::GetMonitorFrequency
 827  *
 828  * Returns the monitor's frequency
 829  *
 830  * Exists in Version 1, 2, 4 and 7
 831  *
 832  * Params:
 833  *  Freq: Pointer to a DWORD to write the frequency to
 834  *
 835  * Returns
 836  *  Always returns DD_OK
 837  *
 838  *****************************************************************************/
 839 static HRESULT WINAPI
 840 IDirectDrawImpl_GetMonitorFrequency(IDirectDraw7 *iface,
 841                                     DWORD *Freq)
 842 {
 843     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
 844     TRACE("(%p)->(%p)\n", This, Freq);
 845
 846     /* Ideally this should be in WineD3D, as it concerns the screen setup,
 847      * but for now this should make the games happy
 848      */
 849     *Freq = 60;
 850     return DD_OK;
 851 }
 852
 853 /*****************************************************************************
 854  * IDirectDraw7::GetVerticalBlankStatus
 855  *
 856  * Returns the Vertical blank status of the monitor. This should be in WineD3D
 857  * too basically, but as it's a semi stub, I didn't create a function there
 858  *
 859  * Params:
 860  *  status: Pointer to a BOOL to be filled with the vertical blank status
 861  *
 862  * Returns
 863  *  DD_OK on success
 864  *  DDERR_INVALIDPARAMS if status is NULL
 865  *
 866  *****************************************************************************/
 867 static HRESULT WINAPI
 868 IDirectDrawImpl_GetVerticalBlankStatus(IDirectDraw7 *iface,
 869                                        BOOL *status)
 870 {
 871     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
 872     TRACE("(%p)->(%p)\n", This, status);
 873
 874     /* This looks sane, the MSDN suggests it too */
 875     EnterCriticalSection(&ddraw_cs);
 876     if(!status)
 877     {
 878         LeaveCriticalSection(&ddraw_cs);
 879         return DDERR_INVALIDPARAMS;
 880     }
 881
 882     *status = This->fake_vblank;
 883     This->fake_vblank = !This->fake_vblank;
 884     LeaveCriticalSection(&ddraw_cs);
 885     return DD_OK;
 886 }
 887
 888 /*****************************************************************************
 889  * IDirectDraw7::GetAvailableVidMem
 890  *
 891  * Returns the total and free video memory
 892  *
 893  * Params:
 894  *  Caps: Specifies the memory type asked for
 895  *  total: Pointer to a DWORD to be filled with the total memory
 896  *  free: Pointer to a DWORD to be filled with the free memory
 897  *
 898  * Returns
 899  *  DD_OK on success
 900  *  DDERR_INVALIDPARAMS of free and total are NULL
 901  *
 902  *****************************************************************************/
 903 static HRESULT WINAPI
 904 IDirectDrawImpl_GetAvailableVidMem(IDirectDraw7 *iface, DDSCAPS2 *Caps, DWORD *total, DWORD *free)
 905 {
 906     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
 907     TRACE("(%p)->(%p, %p, %p)\n", This, Caps, total, free);
 908
 909     if(TRACE_ON(ddraw))
 910     {
 911         TRACE("(%p) Asked for memory with description: ", This);
 912         DDRAW_dump_DDSCAPS2(Caps);
 913         TRACE("\n");
 914     }
 915     EnterCriticalSection(&ddraw_cs);
 916
 917     /* Todo: System memory vs local video memory vs non-local video memory
 918      * The MSDN also mentions differences between texture memory and other
 919      * resources, but that's not important
 920      */
 921
 922     if( (!total) && (!free) )
 923     {
 924         LeaveCriticalSection(&ddraw_cs);
 925         return DDERR_INVALIDPARAMS;
 926     }
 927
 928     if(total) *total = This->total_vidmem;
 929     if(free) *free = IWineD3DDevice_GetAvailableTextureMem(This->wineD3DDevice);
 930
 931     LeaveCriticalSection(&ddraw_cs);
 932     return DD_OK;
 933 }
 934
 935 /*****************************************************************************
 936  * IDirectDraw7::Initialize
 937  *
 938  * Initializes a DirectDraw interface.
 939  *
 940  * Params:
 941  *  GUID: Interface identifier. Well, don't know what this is really good
 942  *   for
 943  *
 944  * Returns
 945  *  Returns DD_OK on the first call,
 946  *  DDERR_ALREADYINITIALIZED on repeated calls
 947  *
 948  *****************************************************************************/
 949 static HRESULT WINAPI
 950 IDirectDrawImpl_Initialize(IDirectDraw7 *iface,
 951                            GUID *Guid)
 952 {
 953     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
 954     TRACE("(%p)->(%s): No-op\n", This, debugstr_guid(Guid));
 955
 956     if(This->initialized)
 957     {
 958         return DDERR_ALREADYINITIALIZED;
 959     }
 960     else
 961     {
 962         return DD_OK;
 963     }
 964 }
 965
 966 /*****************************************************************************
 967  * IDirectDraw7::FlipToGDISurface
 968  *
 969  * "Makes the surface that the GDI writes to the primary surface"
 970  * Looks like some windows specific thing we don't have to care about.
 971  * According to MSDN it permits GDI dialog boxes in FULLSCREEN mode. Good to
 972  * show error boxes ;)
 973  * Well, just return DD_OK.
 974  *
 975  * Returns:
 976  *  Always returns DD_OK
 977  *
 978  *****************************************************************************/
 979 static HRESULT WINAPI
 980 IDirectDrawImpl_FlipToGDISurface(IDirectDraw7 *iface)
 981 {
 982     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
 983     TRACE("(%p)\n", This);
 984
 985     return DD_OK;
 986 }
 987
 988 /*****************************************************************************
 989  * IDirectDraw7::WaitForVerticalBlank
 990  *
 991  * This method allows applications to get in sync with the vertical blank
 992  * interval.
 993  * The wormhole demo in the DirectX 7 sdk uses this call, and it doesn't
 994  * redraw the screen, most likely because of this stub
 995  *
 996  * Parameters:
 997  *  Flags: one of DDWAITVB_BLOCKBEGIN, DDWAITVB_BLOCKBEGINEVENT
 998  *         or DDWAITVB_BLOCKEND
 999  *  h: Not used, according to MSDN
1000  *
1001  * Returns:
1002  *  Always returns DD_OK
1003  *
1004  *****************************************************************************/
1005 static HRESULT WINAPI
1006 IDirectDrawImpl_WaitForVerticalBlank(IDirectDraw7 *iface,
1007                                      DWORD Flags,
1008                                      HANDLE h)
1009 {
1010     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
1011     FIXME("(%p)->(%x,%p): Stub\n", This, Flags, h);
1012
1013     /* MSDN says DDWAITVB_BLOCKBEGINEVENT is not supported */
1014     if(Flags & DDWAITVB_BLOCKBEGINEVENT)
1015         return DDERR_UNSUPPORTED; /* unchecked */
1016
1017     return DD_OK;
1018 }
1019
1020 /*****************************************************************************
1021  * IDirectDraw7::GetScanLine
1022  *
1023  * Returns the scan line that is being drawn on the monitor
1024  *
1025  * Parameters:
1026  *  Scanline: Address to write the scan line value to
1027  *
1028  * Returns:
1029  *  Always returns DD_OK
1030  *
1031  *****************************************************************************/
1032 static HRESULT WINAPI IDirectDrawImpl_GetScanLine(IDirectDraw7 *iface, DWORD *Scanline)
1033 {
1034     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
1035     static BOOL hide = FALSE;
1036     WINED3DDISPLAYMODE Mode;
1037
1038     /* This function is called often, so print the fixme only once */
1039     EnterCriticalSection(&ddraw_cs);
1040     if(!hide)
1041     {
1042         FIXME("(%p)->(%p): Semi-Stub\n", This, Scanline);
1043         hide = TRUE;
1044     }
1045
1046     IWineD3DDevice_GetDisplayMode(This->wineD3DDevice,
1047                                   0,
1048                                   &Mode);
1049
1050     /* Fake the line sweeping of the monitor */
1051     /* FIXME: We should synchronize with a source to keep the refresh rate */
1052     *Scanline = This->cur_scanline++;
1053     /* Assume 20 scan lines in the vertical blank */
1054     if (This->cur_scanline >= Mode.Height + 20)
1055         This->cur_scanline = 0;
1056
1057     LeaveCriticalSection(&ddraw_cs);
1058     return DD_OK;
1059 }
1060
1061 /*****************************************************************************
1062  * IDirectDraw7::TestCooperativeLevel
1063  *
1064  * Informs the application about the state of the video adapter, depending
1065  * on the cooperative level
1066  *
1067  * Returns:
1068  *  DD_OK if the device is in a sane state
1069  *  DDERR_NOEXCLUSIVEMODE or DDERR_EXCLUSIVEMODEALREADYSET
1070  *  if the state is not correct(See below)
1071  *
1072  *****************************************************************************/
1073 static HRESULT WINAPI
1074 IDirectDrawImpl_TestCooperativeLevel(IDirectDraw7 *iface)
1075 {
1076     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
1077     HRESULT hr;
1078     TRACE("(%p)\n", This);
1079
1080     EnterCriticalSection(&ddraw_cs);
1081     /* Description from MSDN:
1082      * For fullscreen apps return DDERR_NOEXCLUSIVEMODE if the user switched
1083      * away from the app with e.g. alt-tab. Windowed apps receive
1084      * DDERR_EXCLUSIVEMODEALREADYSET if another application created a
1085      * DirectDraw object in exclusive mode. DDERR_WRONGMODE is returned,
1086      * when the video mode has changed
1087      */
1088
1089     hr =  IWineD3DDevice_TestCooperativeLevel(This->wineD3DDevice);
1090
1091     /* Fix the result value. These values are mapped from their
1092      * d3d9 counterpart.
1093      */
1094     switch(hr)
1095     {
1096         case WINED3DERR_DEVICELOST:
1097             if(This->cooperative_level & DDSCL_EXCLUSIVE)
1098             {
1099                 LeaveCriticalSection(&ddraw_cs);
1100                 return DDERR_NOEXCLUSIVEMODE;
1101             }
1102             else
1103             {
1104                 LeaveCriticalSection(&ddraw_cs);
1105                 return DDERR_EXCLUSIVEMODEALREADYSET;
1106             }
1107
1108         case WINED3DERR_DEVICENOTRESET:
1109             LeaveCriticalSection(&ddraw_cs);
1110             return DD_OK;
1111
1112         case WINED3D_OK:
1113             LeaveCriticalSection(&ddraw_cs);
1114             return DD_OK;
1115
1116         case WINED3DERR_DRIVERINTERNALERROR:
1117         default:
1118             ERR("(%p) Unexpected return value %08x from wineD3D, "
1119                 " returning DD_OK\n", This, hr);
1120     }
1121
1122     LeaveCriticalSection(&ddraw_cs);
1123     return DD_OK;
1124 }
1125
1126 /*****************************************************************************
1127  * IDirectDraw7::GetGDISurface
1128  *
1129  * Returns the surface that GDI is treating as the primary surface.
1130  * For Wine this is the front buffer
1131  *
1132  * Params:
1133  *  GDISurface: Address to write the surface pointer to
1134  *
1135  * Returns:
1136  *  DD_OK if the surface was found
1137  *  DDERR_NOTFOUND if the GDI surface wasn't found
1138  *
1139  *****************************************************************************/
1140 static HRESULT WINAPI
1141 IDirectDrawImpl_GetGDISurface(IDirectDraw7 *iface,
1142                               IDirectDrawSurface7 **GDISurface)
1143 {
1144     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
1145     IWineD3DSurface *Surf;
1146     IDirectDrawSurface7 *ddsurf;
1147     HRESULT hr;
1148     DDSCAPS2 ddsCaps;
1149     TRACE("(%p)->(%p)\n", This, GDISurface);
1150
1151     /* Get the back buffer from the wineD3DDevice and search its
1152      * attached surfaces for the front buffer
1153      */
1154     EnterCriticalSection(&ddraw_cs);
1155     hr = IWineD3DDevice_GetBackBuffer(This->wineD3DDevice,
1156                                       0, /* SwapChain */
1157                                       0, /* first back buffer*/
1158                                       WINED3DBACKBUFFER_TYPE_MONO,
1159                                       &Surf);
1160
1161     if( (hr != D3D_OK) ||
1162         (!Surf) )
1163     {
1164         ERR("IWineD3DDevice::GetBackBuffer failed\n");
1165         LeaveCriticalSection(&ddraw_cs);
1166         return DDERR_NOTFOUND;
1167     }
1168
1169     /* GetBackBuffer AddRef()ed the surface, release it */
1170     IWineD3DSurface_Release(Surf);
1171
1172     IWineD3DSurface_GetParent(Surf,
1173                               (IUnknown **) &ddsurf);
1174     IDirectDrawSurface7_Release(ddsurf);  /* For the GetParent */
1175
1176     /* Find the front buffer */
1177     ddsCaps.dwCaps = DDSCAPS_FRONTBUFFER;
1178     hr = IDirectDrawSurface7_GetAttachedSurface(ddsurf,
1179                                                 &ddsCaps,
1180                                                 GDISurface);
1181     if(hr != DD_OK)
1182     {
1183         ERR("IDirectDrawSurface7::GetAttachedSurface failed, hr = %x\n", hr);
1184     }
1185
1186     /* The AddRef is OK this time */
1187     LeaveCriticalSection(&ddraw_cs);
1188     return hr;
1189 }
1190
1191 /*****************************************************************************
1192  * IDirectDraw7::EnumDisplayModes
1193  *
1194  * Enumerates the supported Display modes. The modes can be filtered with
1195  * the DDSD parameter.
1196  *
1197  * Params:
1198  *  Flags: can be DDEDM_REFRESHRATES and DDEDM_STANDARDVGAMODES
1199  *  DDSD: Surface description to filter the modes
1200  *  Context: Pointer passed back to the callback function
1201  *  cb: Application-provided callback function
1202  *
1203  * Returns:
1204  *  DD_OK on success
1205  *  DDERR_INVALIDPARAMS if the callback wasn't set
1206  *
1207  *****************************************************************************/
1208 static HRESULT WINAPI
1209 IDirectDrawImpl_EnumDisplayModes(IDirectDraw7 *iface,
1210                                  DWORD Flags,
1211                                  DDSURFACEDESC2 *DDSD,
1212                                  void *Context,
1213                                  LPDDENUMMODESCALLBACK2 cb)
1214 {
1215     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
1216     unsigned int modenum, fmt;
1217     WINED3DFORMAT pixelformat = WINED3DFMT_UNKNOWN;
1218     WINED3DDISPLAYMODE mode;
1219     DDSURFACEDESC2 callback_sd;
1220
1221     WINED3DFORMAT checkFormatList[] =
1222     {
1223         WINED3DFMT_R8G8B8,
1224         WINED3DFMT_A8R8G8B8,
1225         WINED3DFMT_X8R8G8B8,
1226         WINED3DFMT_R5G6B5,
1227         WINED3DFMT_X1R5G5B5,
1228         WINED3DFMT_A1R5G5B5,
1229         WINED3DFMT_A4R4G4B4,
1230         WINED3DFMT_R3G3B2,
1231         WINED3DFMT_A8R3G3B2,
1232         WINED3DFMT_X4R4G4B4,
1233         WINED3DFMT_A2B10G10R10,
1234         WINED3DFMT_A8B8G8R8,
1235         WINED3DFMT_X8B8G8R8,
1236         WINED3DFMT_A2R10G10B10,
1237         WINED3DFMT_A8P8,
1238         WINED3DFMT_P8
1239     };
1240
1241     TRACE("(%p)->(%p,%p,%p): Relay\n", This, DDSD, Context, cb);
1242
1243     EnterCriticalSection(&ddraw_cs);
1244     /* This looks sane */
1245     if(!cb)
1246     {
1247         LeaveCriticalSection(&ddraw_cs);
1248         return DDERR_INVALIDPARAMS;
1249     }
1250
1251     if(DDSD)
1252     {
1253         if ((DDSD->dwFlags & DDSD_PIXELFORMAT) && (DDSD->u4.ddpfPixelFormat.dwFlags & DDPF_RGB) )
1254             pixelformat = PixelFormat_DD2WineD3D(&DDSD->u4.ddpfPixelFormat);
1255     }
1256
1257     for(fmt = 0; fmt < (sizeof(checkFormatList) / sizeof(checkFormatList[0])); fmt++)
1258     {
1259         if(pixelformat != WINED3DFMT_UNKNOWN && checkFormatList[fmt] != pixelformat)
1260         {
1261             continue;
1262         }
1263
1264         modenum = 0;
1265         while(IWineD3D_EnumAdapterModes(This->wineD3D,
1266                                         WINED3DADAPTER_DEFAULT,
1267                                         checkFormatList[fmt],
1268                                         modenum++,
1269                                         &mode) == WINED3D_OK)
1270         {
1271             if(DDSD)
1272             {
1273                 if(DDSD->dwFlags & DDSD_WIDTH && mode.Width != DDSD->dwWidth) continue;
1274                 if(DDSD->dwFlags & DDSD_HEIGHT && mode.Height != DDSD->dwHeight) continue;
1275             }
1276
1277             memset(&callback_sd, 0, sizeof(callback_sd));
1278             callback_sd.dwSize = sizeof(callback_sd);
1279             callback_sd.u4.ddpfPixelFormat.dwSize = sizeof(DDPIXELFORMAT);
1280
1281             callback_sd.dwFlags = DDSD_HEIGHT|DDSD_WIDTH|DDSD_PIXELFORMAT|DDSD_PITCH;
1282             if(Flags & DDEDM_REFRESHRATES)
1283             {
1284                 callback_sd.dwFlags |= DDSD_REFRESHRATE;
1285                 callback_sd.u2.dwRefreshRate = mode.RefreshRate;
1286             }
1287
1288             callback_sd.dwWidth = mode.Width;
1289             callback_sd.dwHeight = mode.Height;
1290
1291             PixelFormat_WineD3DtoDD(&callback_sd.u4.ddpfPixelFormat, mode.Format);
1292
1293             TRACE("Enumerating %dx%d@%d\n", callback_sd.dwWidth, callback_sd.dwHeight, callback_sd.u4.ddpfPixelFormat.u1.dwRGBBitCount);
1294
1295             if(cb(&callback_sd, Context) == DDENUMRET_CANCEL)
1296             {
1297                 TRACE("Application asked to terminate the enumeration\n");
1298                 LeaveCriticalSection(&ddraw_cs);
1299                 return DD_OK;
1300             }
1301         }
1302     }
1303
1304     TRACE("End of enumeration\n");
1305     LeaveCriticalSection(&ddraw_cs);
1306     return DD_OK;
1307 }
1308
1309 /*****************************************************************************
1310  * IDirectDraw7::EvaluateMode
1311  *
1312  * Used with IDirectDraw7::StartModeTest to test video modes.
1313  * EvaluateMode is used to pass or fail a mode, and continue with the next
1314  * mode
1315  *
1316  * Params:
1317  *  Flags: DDEM_MODEPASSED or DDEM_MODEFAILED
1318  *  Timeout: Returns the amount of seconds left before the mode would have
1319  *           been failed automatically
1320  *
1321  * Returns:
1322  *  This implementation always DD_OK, because it's a stub
1323  *
1324  *****************************************************************************/
1325 static HRESULT WINAPI
1326 IDirectDrawImpl_EvaluateMode(IDirectDraw7 *iface,
1327                              DWORD Flags,
1328                              DWORD *Timeout)
1329 {
1330     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
1331     FIXME("(%p)->(%d,%p): Stub!\n", This, Flags, Timeout);
1332
1333     /* When implementing this, implement it in WineD3D */
1334
1335     return DD_OK;
1336 }
1337
1338 /*****************************************************************************
1339  * IDirectDraw7::GetDeviceIdentifier
1340  *
1341  * Returns the device identifier, which gives information about the driver
1342  * Our device identifier is defined at the beginning of this file.
1343  *
1344  * Params:
1345  *  DDDI: Address for the returned structure
1346  *  Flags: Can be DDGDI_GETHOSTIDENTIFIER
1347  *
1348  * Returns:
1349  *  On success it returns DD_OK
1350  *  DDERR_INVALIDPARAMS if DDDI is NULL
1351  *
1352  *****************************************************************************/
1353 static HRESULT WINAPI
1354 IDirectDrawImpl_GetDeviceIdentifier(IDirectDraw7 *iface,
1355                                     DDDEVICEIDENTIFIER2 *DDDI,
1356                                     DWORD Flags)
1357 {
1358     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
1359     TRACE("(%p)->(%p,%08x)\n", This, DDDI, Flags);
1360
1361     if(!DDDI)
1362         return DDERR_INVALIDPARAMS;
1363
1364     /* The DDGDI_GETHOSTIDENTIFIER returns the information about the 2D
1365      * host adapter, if there's a secondary 3D adapter. This doesn't apply
1366      * to any modern hardware, nor is it interesting for Wine, so ignore it
1367      */
1368
1369     *DDDI = deviceidentifier;
1370     return DD_OK;
1371 }
1372
1373 /*****************************************************************************
1374  * IDirectDraw7::GetSurfaceFromDC
1375  *
1376  * Returns the Surface for a GDI device context handle.
1377  * Is this related to IDirectDrawSurface::GetDC ???
1378  *
1379  * Params:
1380  *  hdc: hdc to return the surface for
1381  *  Surface: Address to write the surface pointer to
1382  *
1383  * Returns:
1384  *  Always returns DD_OK because it's a stub
1385  *
1386  *****************************************************************************/
1387 static HRESULT WINAPI
1388 IDirectDrawImpl_GetSurfaceFromDC(IDirectDraw7 *iface,
1389                                  HDC hdc,
1390                                  IDirectDrawSurface7 **Surface)
1391 {
1392     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
1393     FIXME("(%p)->(%p,%p): Stub!\n", This, hdc, Surface);
1394
1395     /* Implementation idea if needed: Loop through all surfaces and compare
1396      * their hdc with hdc. Implement it in WineD3D! */
1397     return DDERR_NOTFOUND;
1398 }
1399
1400 /*****************************************************************************
1401  * IDirectDraw7::RestoreAllSurfaces
1402  *
1403  * Calls the restore method of all surfaces
1404  *
1405  * Params:
1406  *
1407  * Returns:
1408  *  Always returns DD_OK because it's a stub
1409  *
1410  *****************************************************************************/
1411 static HRESULT WINAPI
1412 IDirectDrawImpl_RestoreAllSurfaces(IDirectDraw7 *iface)
1413 {
1414     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
1415     FIXME("(%p): Stub\n", This);
1416
1417     /* This isn't hard to implement: Enumerate all WineD3D surfaces,
1418      * get their parent and call their restore method. Do not implement
1419      * it in WineD3D, as restoring a surface means re-creating the
1420      * WineD3DDSurface
1421      */
1422     return DD_OK;
1423 }
1424
1425 /*****************************************************************************
1426  * IDirectDraw7::StartModeTest
1427  *
1428  * Tests the specified video modes to update the system registry with
1429  * refresh rate information. StartModeTest starts the mode test,
1430  * EvaluateMode is used to fail or pass a mode. If EvaluateMode
1431  * isn't called within 15 seconds, the mode is failed automatically
1432  *
1433  * As refresh rates are handled by the X server, I don't think this
1434  * Method is important
1435  *
1436  * Params:
1437  *  Modes: An array of mode specifications
1438  *  NumModes: The number of modes in Modes
1439  *  Flags: Some flags...
1440  *
1441  * Returns:
1442  *  Returns DDERR_TESTFINISHED if flags contains DDSMT_ISTESTREQUIRED,
1443  *  if no modes are passed, DDERR_INVALIDPARAMS is returned,
1444  *  otherwise DD_OK
1445  *
1446  *****************************************************************************/
1447 static HRESULT WINAPI
1448 IDirectDrawImpl_StartModeTest(IDirectDraw7 *iface,
1449                               SIZE *Modes,
1450                               DWORD NumModes,
1451                               DWORD Flags)
1452 {
1453     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
1454     WARN("(%p)->(%p, %d, %x): Semi-Stub, most likely harmless\n", This, Modes, NumModes, Flags);
1455
1456     /* This looks sane */
1457     if( (!Modes) || (NumModes == 0) ) return DDERR_INVALIDPARAMS;
1458
1459     /* DDSMT_ISTESTREQUIRED asks if a mode test is necessary.
1460      * As it is not, DDERR_TESTFINISHED is returned
1461      * (hopefully that's correct
1462      *
1463     if(Flags & DDSMT_ISTESTREQUIRED) return DDERR_TESTFINISHED;
1464      * well, that value doesn't (yet) exist in the wine headers, so ignore it
1465      */
1466
1467     return DD_OK;
1468 }
1469
1470 /*****************************************************************************
1471  * IDirectDrawImpl_RecreateSurfacesCallback
1472  *
1473  * Enumeration callback for IDirectDrawImpl_RecreateAllSurfaces.
1474  * It re-recreates the WineD3DSurface. It's pretty straightforward
1475  *
1476  *****************************************************************************/
1477 HRESULT WINAPI
1478 IDirectDrawImpl_RecreateSurfacesCallback(IDirectDrawSurface7 *surf,
1479                                          DDSURFACEDESC2 *desc,
1480                                          void *Context)
1481 {
1482     IDirectDrawSurfaceImpl *surfImpl = ICOM_OBJECT(IDirectDrawSurfaceImpl,
1483                                                    IDirectDrawSurface7,
1484                                                    surf);
1485     IDirectDrawImpl *This = surfImpl->ddraw;
1486     IUnknown *Parent;
1487     IParentImpl *parImpl = NULL;
1488     IWineD3DSurface *wineD3DSurface;
1489     HRESULT hr;
1490     void *tmp;
1491     IWineD3DClipper *clipper = NULL;
1492
1493     WINED3DSURFACE_DESC     Desc;
1494     WINED3DFORMAT           Format;
1495     WINED3DRESOURCETYPE     Type;
1496     DWORD                   Usage;
1497     WINED3DPOOL             Pool;
1498     UINT                    Size;
1499
1500     WINED3DMULTISAMPLE_TYPE MultiSampleType;
1501     DWORD                   MultiSampleQuality;
1502     UINT                    Width;
1503     UINT                    Height;
1504
1505     TRACE("(%p): Enumerated Surface %p\n", This, surfImpl);
1506
1507     /* For the enumeration */
1508     IDirectDrawSurface7_Release(surf);
1509
1510     if(surfImpl->ImplType == This->ImplType) return DDENUMRET_OK; /* Continue */
1511
1512     /* Get the objects */
1513     wineD3DSurface = surfImpl->WineD3DSurface;
1514     IWineD3DSurface_GetParent(wineD3DSurface, &Parent);
1515     IUnknown_Release(Parent); /* For the getParent */
1516
1517     /* Is the parent an IParent interface? */
1518     if(IUnknown_QueryInterface(Parent, &IID_IParent, &tmp) == S_OK)
1519     {
1520         /* It is a IParent interface! */
1521         IUnknown_Release(Parent); /* For the QueryInterface */
1522         parImpl = ICOM_OBJECT(IParentImpl, IParent, Parent);
1523         /* Release the reference the parent interface is holding */
1524         IWineD3DSurface_Release(wineD3DSurface);
1525     }
1526
1527     /* get the clipper */
1528     IWineD3DSurface_GetClipper(wineD3DSurface, &clipper);
1529
1530     /* Get the surface properties */
1531     Desc.Format = &Format;
1532     Desc.Type = &Type;
1533     Desc.Usage = &Usage;
1534     Desc.Pool = &Pool;
1535     Desc.Size = &Size;
1536     Desc.MultiSampleType = &MultiSampleType;
1537     Desc.MultiSampleQuality = &MultiSampleQuality;
1538     Desc.Width = &Width;
1539     Desc.Height = &Height;
1540
1541     hr = IWineD3DSurface_GetDesc(wineD3DSurface, &Desc);
1542     if(hr != D3D_OK) return hr;
1543
1544     /* Create the new surface */
1545     hr = IWineD3DDevice_CreateSurface(This->wineD3DDevice,
1546                                       Width, Height, Format,
1547                                       TRUE /* Lockable */,
1548                                       FALSE /* Discard */,
1549                                       surfImpl->mipmap_level,
1550                                       &surfImpl->WineD3DSurface,
1551                                       Type,
1552                                       Usage,
1553                                       Pool,
1554                                       MultiSampleType,
1555                                       MultiSampleQuality,
1556                                       0 /* SharedHandle */,
1557                                       This->ImplType,
1558                                       Parent);
1559
1560     if(hr != D3D_OK)
1561         return hr;
1562
1563     IWineD3DSurface_SetClipper(surfImpl->WineD3DSurface, clipper);
1564
1565     /* Update the IParent if it exists */
1566     if(parImpl)
1567     {
1568         parImpl->child = (IUnknown *) surfImpl->WineD3DSurface;
1569         /* Add a reference for the IParent */
1570         IWineD3DSurface_AddRef(surfImpl->WineD3DSurface);
1571     }
1572     /* TODO: Copy the surface content, except for render targets */
1573
1574     if(IWineD3DSurface_Release(wineD3DSurface) == 0)
1575         TRACE("Surface released successful, next surface\n");
1576     else
1577         ERR("Something's still holding the old WineD3DSurface\n");
1578
1579     surfImpl->ImplType = This->ImplType;
1580
1581     if(clipper)
1582     {
1583         IWineD3DClipper_Release(clipper);
1584     }
1585     return DDENUMRET_OK;
1586 }
1587
1588 /*****************************************************************************
1589  * IDirectDrawImpl_RecreateAllSurfaces
1590  *
1591  * A function, that converts all wineD3DSurfaces to the new implementation type
1592  * It enumerates all surfaces with IWineD3DDevice::EnumSurfaces, creates a
1593  * new WineD3DSurface, copies the content and releases the old surface
1594  *
1595  *****************************************************************************/
1596 static HRESULT
1597 IDirectDrawImpl_RecreateAllSurfaces(IDirectDrawImpl *This)
1598 {
1599     DDSURFACEDESC2 desc;
1600     TRACE("(%p): Switch to implementation %d\n", This, This->ImplType);
1601
1602     if(This->ImplType != SURFACE_OPENGL && This->d3d_initialized)
1603     {
1604         /* Should happen almost never */
1605         FIXME("(%p) Switching to non-opengl surfaces with d3d started. Is this a bug?\n", This);
1606         /* Shutdown d3d */
1607         IWineD3DDevice_Uninit3D(This->wineD3DDevice, D3D7CB_DestroyDepthStencilSurface, D3D7CB_DestroySwapChain);
1608     }
1609     /* Contrary: D3D starting is handled by the caller, because it knows the render target */
1610
1611     memset(&desc, 0, sizeof(desc));
1612     desc.dwSize = sizeof(desc);
1613
1614     return IDirectDraw7_EnumSurfaces(ICOM_INTERFACE(This, IDirectDraw7),
1615                                      0,
1616                                      &desc,
1617                                      This,
1618                                      IDirectDrawImpl_RecreateSurfacesCallback);
1619 }
1620
1621 /*****************************************************************************
1622  * D3D7CB_CreateSurface
1623  *
1624  * Callback function for IDirect3DDevice_CreateTexture. It searches for the
1625  * correct mipmap sublevel, and returns it to WineD3D.
1626  * The surfaces are created already by IDirectDraw7::CreateSurface
1627  *
1628  * Params:
1629  *  With, Height: With and height of the surface
1630  *  Format: The requested format
1631  *  Usage, Pool: D3DUSAGE and D3DPOOL of the surface
1632  *  level: The mipmap level
1633  *  Face: The cube map face type
1634  *  Surface: Pointer to pass the created surface back at
1635  *  SharedHandle: NULL
1636  *
1637  * Returns:
1638  *  D3D_OK
1639  *
1640  *****************************************************************************/
1641 static HRESULT WINAPI
1642 D3D7CB_CreateSurface(IUnknown *device,
1643                      IUnknown *pSuperior,
1644                      UINT Width, UINT Height,
1645                      WINED3DFORMAT Format,
1646                      DWORD Usage, WINED3DPOOL Pool, UINT level,
1647                      WINED3DCUBEMAP_FACES Face,
1648                      IWineD3DSurface **Surface,
1649                      HANDLE *SharedHandle)
1650 {
1651     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, device);
1652     IDirectDrawSurfaceImpl *surf = NULL;
1653     int i = 0;
1654     DDSCAPS2 searchcaps = This->tex_root->surface_desc.ddsCaps;
1655     TRACE("(%p) call back. surf=%p. Face %d level %d\n", device, This->tex_root, Face, level);
1656
1657     searchcaps.dwCaps2 &= ~DDSCAPS2_CUBEMAP_ALLFACES;
1658     switch(Face)
1659     {
1660         case WINED3DCUBEMAP_FACE_POSITIVE_X:
1661             TRACE("Asked for positive x\n");
1662             if(searchcaps.dwCaps2 & DDSCAPS2_CUBEMAP) {
1663                 searchcaps.dwCaps2 |= DDSCAPS2_CUBEMAP_POSITIVEX;
1664             }
1665             surf = This->tex_root; break;
1666         case WINED3DCUBEMAP_FACE_NEGATIVE_X:
1667             TRACE("Asked for negative x\n");
1668             searchcaps.dwCaps2 |= DDSCAPS2_CUBEMAP_NEGATIVEX; break;
1669         case WINED3DCUBEMAP_FACE_POSITIVE_Y:
1670             TRACE("Asked for positive y\n");
1671             searchcaps.dwCaps2 |= DDSCAPS2_CUBEMAP_POSITIVEY; break;
1672         case WINED3DCUBEMAP_FACE_NEGATIVE_Y:
1673             TRACE("Asked for negative y\n");
1674             searchcaps.dwCaps2 |= DDSCAPS2_CUBEMAP_NEGATIVEY; break;
1675         case WINED3DCUBEMAP_FACE_POSITIVE_Z:
1676             TRACE("Asked for positive z\n");
1677             searchcaps.dwCaps2 |= DDSCAPS2_CUBEMAP_POSITIVEZ; break;
1678         case WINED3DCUBEMAP_FACE_NEGATIVE_Z:
1679             TRACE("Asked for negative z\n");
1680             searchcaps.dwCaps2 |= DDSCAPS2_CUBEMAP_NEGATIVEZ; break;
1681         default: {ERR("Unexpected cube face\n");} /* Stupid compiler */
1682     }
1683
1684     if(!surf)
1685     {
1686         IDirectDrawSurface7 *attached;
1687         IDirectDrawSurface7_GetAttachedSurface(ICOM_INTERFACE(This->tex_root, IDirectDrawSurface7),
1688                                                &searchcaps,
1689                                                &attached);
1690         surf = ICOM_OBJECT(IDirectDrawSurfaceImpl, IDirectDrawSurface7, attached);
1691         IDirectDrawSurface7_Release(attached);
1692     }
1693     if(!surf) ERR("root search surface not found\n");
1694
1695     /* Find the wanted mipmap. There are enough mipmaps in the chain */
1696     while(i < level)
1697     {
1698         IDirectDrawSurface7 *attached;
1699         IDirectDrawSurface7_GetAttachedSurface(ICOM_INTERFACE(surf, IDirectDrawSurface7),
1700                                                &searchcaps,
1701                                                &attached);
1702         if(!attached) ERR("Surface not found\n");
1703         surf = ICOM_OBJECT(IDirectDrawSurfaceImpl, IDirectDrawSurface7, attached);
1704         IDirectDrawSurface7_Release(attached);
1705         i++;
1706     }
1707
1708     /* Return the surface */
1709     *Surface = surf->WineD3DSurface;
1710
1711     TRACE("Returning wineD3DSurface %p, it belongs to surface %p\n", *Surface, surf);
1712     return D3D_OK;
1713 }
1714
1715 ULONG WINAPI D3D7CB_DestroySwapChain(IWineD3DSwapChain *pSwapChain) {
1716     IUnknown* swapChainParent;
1717     TRACE("(%p) call back\n", pSwapChain);
1718
1719     IWineD3DSwapChain_GetParent(pSwapChain, &swapChainParent);
1720     IUnknown_Release(swapChainParent);
1721     return IUnknown_Release(swapChainParent);
1722 }
1723
1724 ULONG WINAPI D3D7CB_DestroyDepthStencilSurface(IWineD3DSurface *pSurface) {
1725     IUnknown* surfaceParent;
1726     TRACE("(%p) call back\n", pSurface);
1727
1728     IWineD3DSurface_GetParent(pSurface, &surfaceParent);
1729     IUnknown_Release(surfaceParent);
1730     return IUnknown_Release(surfaceParent);
1731 }
1732
1733 /*****************************************************************************
1734  * IDirectDrawImpl_CreateNewSurface
1735  *
1736  * A helper function for IDirectDraw7::CreateSurface. It creates a new surface
1737  * with the passed parameters.
1738  *
1739  * Params:
1740  *  DDSD: Description of the surface to create
1741  *  Surf: Address to store the interface pointer at
1742  *
1743  * Returns:
1744  *  DD_OK on success
1745  *
1746  *****************************************************************************/
1747 static HRESULT WINAPI
1748 IDirectDrawImpl_CreateNewSurface(IDirectDrawImpl *This,
1749                                  DDSURFACEDESC2 *pDDSD,
1750                                  IDirectDrawSurfaceImpl **ppSurf,
1751                                  UINT level)
1752 {
1753     HRESULT hr;
1754     UINT Width = 0, Height = 0;
1755     WINED3DFORMAT Format = WINED3DFMT_UNKNOWN;
1756     WINED3DRESOURCETYPE ResType = WINED3DRTYPE_SURFACE;
1757     DWORD Usage = 0;
1758     WINED3DSURFTYPE ImplType = This->ImplType;
1759     WINED3DSURFACE_DESC Desc;
1760     IUnknown *Parent;
1761     IParentImpl *parImpl = NULL;
1762     WINED3DPOOL Pool = WINED3DPOOL_DEFAULT;
1763
1764     /* Dummies for GetDesc */
1765     WINED3DPOOL dummy_d3dpool;
1766     WINED3DMULTISAMPLE_TYPE dummy_mst;
1767     UINT dummy_uint;
1768     DWORD dummy_dword;
1769
1770     if (TRACE_ON(ddraw))
1771     {
1772         TRACE(" (%p) Requesting surface desc :\n", This);
1773         DDRAW_dump_surface_desc(pDDSD);
1774     }
1775
1776     /* Select the surface type, if it wasn't choosen yet */
1777     if(ImplType == SURFACE_UNKNOWN)
1778     {
1779         /* Use GL Surfaces if a D3DDEVICE Surface is requested */
1780         if(pDDSD->ddsCaps.dwCaps & DDSCAPS_3DDEVICE)
1781         {
1782             TRACE("(%p) Choosing GL surfaces because a 3DDEVICE Surface was requested\n", This);
1783             ImplType = SURFACE_OPENGL;
1784         }
1785
1786         /* Otherwise use GDI surfaces for now */
1787         else
1788         {
1789             TRACE("(%p) Choosing GDI surfaces for 2D rendering\n", This);
1790             ImplType = SURFACE_GDI;
1791         }
1792
1793         /* Policy if all surface implementations are available:
1794          * First, check if a default type was set with winecfg. If not,
1795          * try Xrender surfaces, and use them if they work. Next, check if
1796          * accelerated OpenGL is available, and use GL surfaces in this
1797          * case. If all else fails, use GDI surfaces. If a 3DDEVICE surface
1798          * was created, always use OpenGL surfaces.
1799          *
1800          * (Note: Xrender surfaces are not implemented for now, the
1801          * unaccelerated implementation uses GDI to render in Software)
1802          */
1803
1804         /* Store the type. If it needs to be changed, all WineD3DSurfaces have to
1805          * be re-created. This could be done with IDirectDrawSurface7::Restore
1806          */
1807         This->ImplType = ImplType;
1808     }
1809     else
1810     {
1811          if((pDDSD->ddsCaps.dwCaps & DDSCAPS_3DDEVICE ) &&
1812             (This->ImplType != SURFACE_OPENGL ) && DefaultSurfaceType == SURFACE_UNKNOWN)
1813         {
1814             /* We have to change to OpenGL,
1815              * and re-create all WineD3DSurfaces
1816              */
1817             ImplType = SURFACE_OPENGL;
1818             This->ImplType = ImplType;
1819             TRACE("(%p) Re-creating all surfaces\n", This);
1820             IDirectDrawImpl_RecreateAllSurfaces(This);
1821             TRACE("(%p) Done recreating all surfaces\n", This);
1822         }
1823         else if(This->ImplType != SURFACE_OPENGL && pDDSD->ddsCaps.dwCaps & DDSCAPS_3DDEVICE)
1824         {
1825             WARN("The application requests a 3D capable surface, but a non-opengl surface was set in the registry\n");
1826             /* Do not fail surface creation, only fail 3D device creation */
1827         }
1828     }
1829
1830     /* Get the correct wined3d usage */
1831     if (pDDSD->ddsCaps.dwCaps & (DDSCAPS_PRIMARYSURFACE |
1832                                  DDSCAPS_BACKBUFFER     |
1833                                  DDSCAPS_3DDEVICE       ) )
1834     {
1835         Usage |= WINED3DUSAGE_RENDERTARGET;
1836
1837         pDDSD->ddsCaps.dwCaps |= DDSCAPS_VIDEOMEMORY |
1838                                  DDSCAPS_VISIBLE;
1839     }
1840     if (pDDSD->ddsCaps.dwCaps & (DDSCAPS_OVERLAY))
1841     {
1842         Usage |= WINED3DUSAGE_OVERLAY;
1843     }
1844     if(This->depthstencil || (pDDSD->ddsCaps.dwCaps & DDSCAPS_ZBUFFER) )
1845     {
1846         /* The depth stencil creation callback sets this flag.
1847          * Set the WineD3D usage to let it know that it's a depth
1848          * Stencil surface.
1849          */
1850         Usage |= WINED3DUSAGE_DEPTHSTENCIL;
1851     }
1852     if(pDDSD->ddsCaps.dwCaps & DDSCAPS_SYSTEMMEMORY)
1853     {
1854         Pool = WINED3DPOOL_SYSTEMMEM;
1855     }
1856     else if(pDDSD->ddsCaps.dwCaps2 & DDSCAPS2_TEXTUREMANAGE)
1857     {
1858         Pool = WINED3DPOOL_MANAGED;
1859         /* Managed textures have the system memory flag set */
1860         pDDSD->ddsCaps.dwCaps |= DDSCAPS_SYSTEMMEMORY;
1861     }
1862     else if(pDDSD->ddsCaps.dwCaps & DDSCAPS_VIDEOMEMORY)
1863     {
1864         /* Videomemory adds localvidmem, this is mutually exclusive with systemmemory
1865          * and texturemanage
1866          */
1867         pDDSD->ddsCaps.dwCaps |= DDSCAPS_LOCALVIDMEM;
1868     }
1869
1870     Format = PixelFormat_DD2WineD3D(&pDDSD->u4.ddpfPixelFormat);
1871     if(Format == WINED3DFMT_UNKNOWN)
1872     {
1873         ERR("Unsupported / Unknown pixelformat\n");
1874         return DDERR_INVALIDPIXELFORMAT;
1875     }
1876
1877     /* Create the Surface object */
1878     *ppSurf = HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, sizeof(IDirectDrawSurfaceImpl));
1879     if(!*ppSurf)
1880     {
1881         ERR("(%p) Error allocating memory for a surface\n", This);
1882         return DDERR_OUTOFVIDEOMEMORY;
1883     }
1884     ICOM_INIT_INTERFACE(*ppSurf, IDirectDrawSurface7, IDirectDrawSurface7_Vtbl);
1885     ICOM_INIT_INTERFACE(*ppSurf, IDirectDrawSurface3, IDirectDrawSurface3_Vtbl);
1886     ICOM_INIT_INTERFACE(*ppSurf, IDirectDrawGammaControl, IDirectDrawGammaControl_Vtbl);
1887     ICOM_INIT_INTERFACE(*ppSurf, IDirect3DTexture2, IDirect3DTexture2_Vtbl);
1888     ICOM_INIT_INTERFACE(*ppSurf, IDirect3DTexture, IDirect3DTexture1_Vtbl);
1889     (*ppSurf)->ref = 1;
1890     (*ppSurf)->version = 7;
1891     (*ppSurf)->ddraw = This;
1892     (*ppSurf)->surface_desc.dwSize = sizeof(DDSURFACEDESC2);
1893     (*ppSurf)->surface_desc.u4.ddpfPixelFormat.dwSize = sizeof(DDPIXELFORMAT);
1894     DD_STRUCT_COPY_BYSIZE(&(*ppSurf)->surface_desc, pDDSD);
1895
1896     /* Surface attachments */
1897     (*ppSurf)->next_attached = NULL;
1898     (*ppSurf)->first_attached = *ppSurf;
1899
1900     /* Needed to re-create the surface on an implementation change */
1901     (*ppSurf)->ImplType = ImplType;
1902
1903     /* For D3DDevice creation */
1904     (*ppSurf)->isRenderTarget = FALSE;
1905
1906     /* A trace message for debugging */
1907     TRACE("(%p) Created IDirectDrawSurface implementation structure at %p\n", This, *ppSurf);
1908
1909     if(pDDSD->ddsCaps.dwCaps & ( DDSCAPS_PRIMARYSURFACE | DDSCAPS_TEXTURE | DDSCAPS_3DDEVICE) )
1910     {
1911         /* Render targets and textures need a IParent interface,
1912          * because WineD3D will destroy them when the swapchain
1913          * is released
1914          */
1915         parImpl = HeapAlloc(GetProcessHeap(), 0, sizeof(IParentImpl));
1916         if(!parImpl)
1917         {
1918             ERR("Out of memory when allocating memory for a IParent implementation\n");
1919             return DDERR_OUTOFMEMORY;
1920         }
1921         parImpl->ref = 1;
1922         ICOM_INIT_INTERFACE(parImpl, IParent, IParent_Vtbl);
1923         Parent = (IUnknown *) ICOM_INTERFACE(parImpl, IParent);
1924         TRACE("Using IParent interface %p as parent\n", parImpl);
1925     }
1926     else
1927     {
1928         /* Use the surface as parent */
1929         Parent = (IUnknown *) ICOM_INTERFACE(*ppSurf, IDirectDrawSurface7);
1930         TRACE("Using Surface interface %p as parent\n", *ppSurf);
1931     }
1932
1933     /* Now create the WineD3D Surface */
1934     hr = IWineD3DDevice_CreateSurface(This->wineD3DDevice,
1935                                       pDDSD->dwWidth,
1936                                       pDDSD->dwHeight,
1937                                       Format,
1938                                       TRUE /* Lockable */,
1939                                       FALSE /* Discard */,
1940                                       level,
1941                                       &(*ppSurf)->WineD3DSurface,
1942                                       ResType, Usage,
1943                                       Pool,
1944                                       WINED3DMULTISAMPLE_NONE,
1945                                       0 /* MultiSampleQuality */,
1946                                       0 /* SharedHandle */,
1947                                       ImplType,
1948                                       Parent);
1949
1950     if(hr != D3D_OK)
1951     {
1952         ERR("IWineD3DDevice::CreateSurface failed. hr = %08x\n", hr);
1953         return hr;
1954     }
1955
1956     /* Set the child of the parent implementation if it exists */
1957     if(parImpl)
1958     {
1959         parImpl->child = (IUnknown *) (*ppSurf)->WineD3DSurface;
1960         /* The IParent releases the WineD3DSurface, and
1961          * the ddraw surface does that too. Hold a reference
1962          */
1963         IWineD3DSurface_AddRef((*ppSurf)->WineD3DSurface);
1964     }
1965
1966     /* Increase the surface counter, and attach the surface */
1967     InterlockedIncrement(&This->surfaces);
1968     list_add_head(&This->surface_list, &(*ppSurf)->surface_list_entry);
1969
1970     /* Here we could store all created surfaces in the DirectDrawImpl structure,
1971      * But this could also be delegated to WineDDraw, as it keeps track of all its
1972      * resources. Not implemented for now, as there are more important things ;)
1973      */
1974
1975     /* Get the pixel format of the WineD3DSurface and store it.
1976      * Don't use the Format choosen above, WineD3D might have
1977      * changed it
1978      */
1979     Desc.Format = &Format;
1980     Desc.Type = &ResType;
1981     Desc.Usage = &Usage;
1982     Desc.Pool = &dummy_d3dpool;
1983     Desc.Size = &dummy_uint;
1984     Desc.MultiSampleType = &dummy_mst;
1985     Desc.MultiSampleQuality = &dummy_dword;
1986     Desc.Width = &Width;
1987     Desc.Height = &Height;
1988
1989     (*ppSurf)->surface_desc.dwFlags |= DDSD_PIXELFORMAT;
1990     hr = IWineD3DSurface_GetDesc((*ppSurf)->WineD3DSurface, &Desc);
1991     if(hr != D3D_OK)
1992     {
1993         ERR("IWineD3DSurface::GetDesc failed\n");
1994         IDirectDrawSurface7_Release( (IDirectDrawSurface7 *) *ppSurf);
1995         return hr;
1996     }
1997
1998     if(Format == WINED3DFMT_UNKNOWN)
1999     {
2000         FIXME("IWineD3DSurface::GetDesc returned WINED3DFMT_UNKNOWN\n");
2001     }
2002     PixelFormat_WineD3DtoDD( &(*ppSurf)->surface_desc.u4.ddpfPixelFormat, Format);
2003
2004     /* Anno 1602 stores the pitch right after surface creation, so make sure it's there.
2005      * I can't LockRect() the surface here because if OpenGL surfaces are in use, the
2006      * WineD3DDevice might not be useable for 3D yet, so an extra method was created.
2007      * TODO: Test other fourcc formats
2008      */
2009     if(Format == WINED3DFMT_DXT1 || Format == WINED3DFMT_DXT2 || Format == WINED3DFMT_DXT3 ||
2010        Format == WINED3DFMT_DXT4 || Format == WINED3DFMT_DXT5)
2011     {
2012         (*ppSurf)->surface_desc.dwFlags |= DDSD_LINEARSIZE;
2013         if(Format == WINED3DFMT_DXT1)
2014         {
2015             (*ppSurf)->surface_desc.u1.dwLinearSize = max(4, Width) * max(4, Height) / 2;
2016         }
2017         else
2018         {
2019             (*ppSurf)->surface_desc.u1.dwLinearSize = max(4, Width) * max(4, Height);
2020         }
2021     }
2022     else
2023     {
2024         (*ppSurf)->surface_desc.dwFlags |= DDSD_PITCH;
2025         (*ppSurf)->surface_desc.u1.lPitch = IWineD3DSurface_GetPitch((*ppSurf)->WineD3DSurface);
2026     }
2027
2028     /* Application passed a color key? Set it! */
2029     if(pDDSD->dwFlags & DDSD_CKDESTOVERLAY)
2030     {
2031         IWineD3DSurface_SetColorKey((*ppSurf)->WineD3DSurface,
2032                                     DDCKEY_DESTOVERLAY,
2033                                     (WINEDDCOLORKEY *) &pDDSD->u3.ddckCKDestOverlay);
2034     }
2035     if(pDDSD->dwFlags & DDSD_CKDESTBLT)
2036     {
2037         IWineD3DSurface_SetColorKey((*ppSurf)->WineD3DSurface,
2038                                     DDCKEY_DESTBLT,
2039                                     (WINEDDCOLORKEY *) &pDDSD->ddckCKDestBlt);
2040     }
2041     if(pDDSD->dwFlags & DDSD_CKSRCOVERLAY)
2042     {
2043         IWineD3DSurface_SetColorKey((*ppSurf)->WineD3DSurface,
2044                                     DDCKEY_SRCOVERLAY,
2045                                     (WINEDDCOLORKEY *) &pDDSD->ddckCKSrcOverlay);
2046     }
2047     if(pDDSD->dwFlags & DDSD_CKSRCBLT)
2048     {
2049         IWineD3DSurface_SetColorKey((*ppSurf)->WineD3DSurface,
2050                                     DDCKEY_SRCBLT,
2051                                     (WINEDDCOLORKEY *) &pDDSD->ddckCKSrcBlt);
2052     }
2053     if ( pDDSD->dwFlags & DDSD_LPSURFACE)
2054     {
2055         hr = IWineD3DSurface_SetMem((*ppSurf)->WineD3DSurface, pDDSD->lpSurface);
2056         if(hr != WINED3D_OK)
2057         {
2058             /* No need for a trace here, wined3d does that for us */
2059             IDirectDrawSurface7_Release(ICOM_INTERFACE((*ppSurf), IDirectDrawSurface7));
2060             return hr;
2061         }
2062     }
2063
2064     return DD_OK;
2065 }
2066 /*****************************************************************************
2067  * CreateAdditionalSurfaces
2068  *
2069  * Creates a new mipmap chain.
2070  *
2071  * Params:
2072  *  root: Root surface to attach the newly created chain to
2073  *  count: number of surfaces to create
2074  *  DDSD: Description of the surface. Intentionally not a pointer to avoid side
2075  *        effects on the caller
2076  *  CubeFaceRoot: Whether the new surface is a root of a cube map face. This
2077  *                creates an additional surface without the mipmapping flags
2078  *
2079  *****************************************************************************/
2080 static HRESULT
2081 CreateAdditionalSurfaces(IDirectDrawImpl *This,
2082                          IDirectDrawSurfaceImpl *root,
2083                          UINT count,
2084                          DDSURFACEDESC2 DDSD,
2085                          BOOL CubeFaceRoot)
2086 {
2087     UINT i, j, level = 0;
2088     HRESULT hr;
2089     IDirectDrawSurfaceImpl *last = root;
2090
2091     for(i = 0; i < count; i++)
2092     {
2093         IDirectDrawSurfaceImpl *object2 = NULL;
2094
2095         /* increase the mipmap level, but only if a mipmap is created
2096          * In this case, also halve the size
2097          */
2098         if(DDSD.ddsCaps.dwCaps & DDSCAPS_MIPMAP && !CubeFaceRoot)
2099         {
2100             level++;
2101             if(DDSD.dwWidth > 1) DDSD.dwWidth /= 2;
2102             if(DDSD.dwHeight > 1) DDSD.dwHeight /= 2;
2103             /* Set the mipmap sublevel flag according to msdn */
2104             DDSD.ddsCaps.dwCaps2 |= DDSCAPS2_MIPMAPSUBLEVEL;
2105         }
2106         else
2107         {
2108             DDSD.ddsCaps.dwCaps2 &= ~DDSCAPS2_MIPMAPSUBLEVEL;
2109         }
2110         CubeFaceRoot = FALSE;
2111
2112         hr = IDirectDrawImpl_CreateNewSurface(This,
2113                                               &DDSD,
2114                                               &object2,
2115                                               level);
2116         if(hr != DD_OK)
2117         {
2118             return hr;
2119         }
2120
2121         /* Add the new surface to the complex attachment array */
2122         for(j = 0; j < MAX_COMPLEX_ATTACHED; j++)
2123         {
2124             if(last->complex_array[j]) continue;
2125             last->complex_array[j] = object2;
2126             break;
2127         }
2128         last = object2;
2129
2130         /* Remove the (possible) back buffer cap from the new surface description,
2131          * because only one surface in the flipping chain is a back buffer, one
2132          * is a front buffer, the others are just primary surfaces.
2133          */
2134         DDSD.ddsCaps.dwCaps &= ~DDSCAPS_BACKBUFFER;
2135     }
2136     return DD_OK;
2137 }
2138
2139 /*****************************************************************************
2140  * IDirectDraw7::CreateSurface
2141  *
2142  * Creates a new IDirectDrawSurface object and returns its interface.
2143  *
2144  * The surface connections with wined3d are a bit tricky. Basically it works
2145  * like this:
2146  *
2147  * |------------------------|               |-----------------|
2148  * | DDraw surface          |               | WineD3DSurface  |
2149  * |                        |               |                 |
2150  * |        WineD3DSurface  |-------------->|                 |
2151  * |        Child           |<------------->| Parent          |
2152  * |------------------------|               |-----------------|
2153  *
2154  * The DDraw surface is the parent of the wined3d surface, and it releases
2155  * the WineD3DSurface when the ddraw surface is destroyed.
2156  *
2157  * However, for all surfaces which can be in a container in WineD3D,
2158  * we have to do this. These surfaces are ususally complex surfaces,
2159  * so this concerns primary surfaces with a front and a back buffer,
2160  * and textures.
2161  *
2162  * |------------------------|               |-----------------|
2163  * | DDraw surface          |               | Containter      |
2164  * |                        |               |                 |
2165  * |                  Child |<------------->| Parent          |
2166  * |                Texture |<------------->|                 |
2167  * |         WineD3DSurface |<----|         |          Levels |<--|
2168  * | Complex connection     |     |         |                 |   |
2169  * |------------------------|     |         |-----------------|   |
2170  *  ^                             |                               |
2171  *  |                             |                               |
2172  *  |                             |                               |
2173  *  |    |------------------|     |         |-----------------|   |
2174  *  |    | IParent          |     |-------->| WineD3DSurface  |   |
2175  *  |    |                  |               |                 |   |
2176  *  |    |            Child |<------------->| Parent          |   |
2177  *  |    |                  |               |       Container |<--|
2178  *  |    |------------------|               |-----------------|   |
2179  *  |                                                             |
2180  *  |   |----------------------|                                  |
2181  *  |   | DDraw surface 2      |                                  |
2182  *  |   |                      |                                  |
2183  *  |<->| Complex root   Child |                                  |
2184  *  |   |              Texture |                                  |
2185  *  |   |       WineD3DSurface |<----|                            |
2186  *  |   |----------------------|     |                            |
2187  *  |                                |                            |
2188  *  |    |---------------------|     |      |-----------------|   |
2189  *  |    | IParent             |     |----->| WineD3DSurface  |   |
2190  *  |    |                     |            |                 |   |
2191  *  |    |               Child |<---------->| Parent          |   |
2192  *  |    |---------------------|            |       Container |<--|
2193  *  |                                       |-----------------|   |
2194  *  |                                                             |
2195  *  |             ---More surfaces can follow---                  |
2196  *
2197  * The reason is that the IWineD3DSwapchain(render target container)
2198  * and the IWineD3DTexure(Texture container) release the parents
2199  * of their surface's children, but by releasing the complex root
2200  * the surfaces which are complexly attached to it are destroyed
2201  * too. See IDirectDrawSurface::Release for a more detailed
2202  * explanation.
2203  *
2204  * Params:
2205  *  DDSD: Description of the surface to create
2206  *  Surf: Address to store the interface pointer at
2207  *  UnkOuter: Basically for aggregation support, but ddraw doesn't support
2208  *            aggregation, so it has to be NULL
2209  *
2210  * Returns:
2211  *  DD_OK on success
2212  *  CLASS_E_NOAGGREGATION if UnkOuter != NULL
2213  *  DDERR_* if an error occurs
2214  *
2215  *****************************************************************************/
2216 static HRESULT WINAPI
2217 IDirectDrawImpl_CreateSurface(IDirectDraw7 *iface,
2218                               DDSURFACEDESC2 *DDSD,
2219                               IDirectDrawSurface7 **Surf,
2220                               IUnknown *UnkOuter)
2221 {
2222     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
2223     IDirectDrawSurfaceImpl *object = NULL;
2224     HRESULT hr;
2225     LONG extra_surfaces = 0;
2226     DDSURFACEDESC2 desc2;
2227     WINED3DDISPLAYMODE Mode;
2228
2229     TRACE("(%p)->(%p,%p,%p)\n", This, DDSD, Surf, UnkOuter);
2230
2231     /* Some checks before we start */
2232     if (TRACE_ON(ddraw))
2233     {
2234         TRACE(" (%p) Requesting surface desc :\n", This);
2235         DDRAW_dump_surface_desc(DDSD);
2236     }
2237     EnterCriticalSection(&ddraw_cs);
2238
2239     if (UnkOuter != NULL)
2240     {
2241         FIXME("(%p) : outer != NULL?\n", This);
2242         LeaveCriticalSection(&ddraw_cs);
2243         return CLASS_E_NOAGGREGATION; /* unchecked */
2244     }
2245
2246     if (Surf == NULL)
2247     {
2248         FIXME("(%p) You want to get back a surface? Don't give NULL ptrs!\n", This);
2249         LeaveCriticalSection(&ddraw_cs);
2250         return E_POINTER; /* unchecked */
2251     }
2252
2253     if (!(DDSD->dwFlags & DDSD_CAPS))
2254     {
2255         /* DVIDEO.DLL does forget the DDSD_CAPS flag ... *sigh* */
2256         DDSD->dwFlags |= DDSD_CAPS;
2257     }
2258     if (DDSD->ddsCaps.dwCaps == 0)
2259     {
2260         /* This has been checked on real Windows */
2261         DDSD->ddsCaps.dwCaps = DDSCAPS_LOCALVIDMEM | DDSCAPS_VIDEOMEMORY;
2262     }
2263
2264     if (DDSD->ddsCaps.dwCaps & DDSCAPS_ALLOCONLOAD)
2265     {
2266         /* If the surface is of the 'alloconload' type, ignore the LPSURFACE field */
2267         DDSD->dwFlags &= ~DDSD_LPSURFACE;
2268     }
2269
2270     if ((DDSD->dwFlags & DDSD_LPSURFACE) && (DDSD->lpSurface == NULL))
2271     {
2272         /* Frank Herbert's Dune specifies a null pointer for the surface, ignore the LPSURFACE field */
2273         WARN("(%p) Null surface pointer specified, ignore it!\n", This);
2274         DDSD->dwFlags &= ~DDSD_LPSURFACE;
2275     }
2276
2277     if((DDSD->ddsCaps.dwCaps & (DDSCAPS_FLIP | DDSCAPS_PRIMARYSURFACE)) == (DDSCAPS_FLIP | DDSCAPS_PRIMARYSURFACE) &&
2278        !(This->cooperative_level & DDSCL_EXCLUSIVE))
2279     {
2280         TRACE("(%p): Attempt to create a flipable primary surface without DDSCL_EXCLUSIVE set\n", This);
2281         *Surf = NULL;
2282         LeaveCriticalSection(&ddraw_cs);
2283         return DDERR_NOEXCLUSIVEMODE;
2284     }
2285
2286     if(DDSD->ddsCaps.dwCaps & (DDSCAPS_FRONTBUFFER | DDSCAPS_BACKBUFFER)) {
2287         WARN("Application tried to create an explicit front or back buffer\n");
2288         LeaveCriticalSection(&ddraw_cs);
2289         return DDERR_INVALIDCAPS;
2290     }
2291     /* Check cube maps but only if the size includes them */
2292     if (DDSD->dwSize >= sizeof(DDSURFACEDESC2))
2293     {
2294         if(DDSD->ddsCaps.dwCaps2 & DDSCAPS2_CUBEMAP_ALLFACES &&
2295            !(DDSD->ddsCaps.dwCaps2 & DDSCAPS2_CUBEMAP))
2296         {
2297             WARN("Cube map faces requested without cube map flag\n");
2298             LeaveCriticalSection(&ddraw_cs);
2299             return DDERR_INVALIDCAPS;
2300         }
2301         if(DDSD->ddsCaps.dwCaps2 & DDSCAPS2_CUBEMAP &&
2302            (DDSD->ddsCaps.dwCaps2 & DDSCAPS2_CUBEMAP_ALLFACES) == 0)
2303         {
2304             WARN("Cube map without faces requested\n");
2305             LeaveCriticalSection(&ddraw_cs);
2306             return DDERR_INVALIDPARAMS;
2307         }
2308
2309         /* Quick tests confirm those can be created, but we don't do that yet */
2310         if(DDSD->ddsCaps.dwCaps2 & DDSCAPS2_CUBEMAP &&
2311            (DDSD->ddsCaps.dwCaps2 & DDSCAPS2_CUBEMAP_ALLFACES) != DDSCAPS2_CUBEMAP_ALLFACES)
2312         {
2313             FIXME("Partial cube maps not supported yet\n");
2314         }
2315     }
2316
2317     /* According to the msdn this flag is ignored by CreateSurface */
2318     if (DDSD->dwSize >= sizeof(DDSURFACEDESC2))
2319         DDSD->ddsCaps.dwCaps2 &= ~DDSCAPS2_MIPMAPSUBLEVEL;
2320
2321     /* Modify some flags */
2322     memset(&desc2, 0, sizeof(desc2));
2323     desc2.dwSize = sizeof(desc2);   /* For the struct copy */
2324     DD_STRUCT_COPY_BYSIZE(&desc2, DDSD);
2325     desc2.dwSize = sizeof(desc2);   /* To override a possibly smaller size */
2326     desc2.u4.ddpfPixelFormat.dwSize=sizeof(DDPIXELFORMAT); /* Just to be sure */
2327
2328     /* Get the video mode from WineD3D - we will need it */
2329     hr = IWineD3DDevice_GetDisplayMode(This->wineD3DDevice,
2330                                        0, /* Swapchain 0 */
2331                                        &Mode);
2332     if(FAILED(hr))
2333     {
2334         ERR("Failed to read display mode from wined3d\n");
2335         switch(This->orig_bpp)
2336         {
2337             case 8:
2338                 Mode.Format = WINED3DFMT_P8;
2339                 break;
2340
2341             case 15:
2342                 Mode.Format = WINED3DFMT_X1R5G5B5;
2343                 break;
2344
2345             case 16:
2346                 Mode.Format = WINED3DFMT_R5G6B5;
2347                 break;
2348
2349             case 24:
2350                 Mode.Format = WINED3DFMT_R8G8B8;
2351                 break;
2352
2353             case 32:
2354                 Mode.Format = WINED3DFMT_X8R8G8B8;
2355                 break;
2356         }
2357         Mode.Width = This->orig_width;
2358         Mode.Height = This->orig_height;
2359     }
2360
2361     /* No pixelformat given? Use the current screen format */
2362     if(!(desc2.dwFlags & DDSD_PIXELFORMAT))
2363     {
2364         desc2.dwFlags |= DDSD_PIXELFORMAT;
2365         desc2.u4.ddpfPixelFormat.dwSize=sizeof(DDPIXELFORMAT);
2366
2367         /* Wait: It could be a Z buffer */
2368         if(desc2.ddsCaps.dwCaps & DDSCAPS_ZBUFFER)
2369         {
2370             switch(desc2.u2.dwMipMapCount) /* Who had this glorious idea? */
2371             {
2372                 case 15:
2373                     PixelFormat_WineD3DtoDD(&desc2.u4.ddpfPixelFormat, WINED3DFMT_D15S1);
2374                     break;
2375                 case 16:
2376                     PixelFormat_WineD3DtoDD(&desc2.u4.ddpfPixelFormat, WINED3DFMT_D16);
2377                     break;
2378                 case 24:
2379                     PixelFormat_WineD3DtoDD(&desc2.u4.ddpfPixelFormat, WINED3DFMT_D24X8);
2380                     break;
2381                 case 32:
2382                     PixelFormat_WineD3DtoDD(&desc2.u4.ddpfPixelFormat, WINED3DFMT_D32);
2383                     break;
2384                 default:
2385                     ERR("Unknown Z buffer bit depth\n");
2386             }
2387         }
2388         else
2389         {
2390             PixelFormat_WineD3DtoDD(&desc2.u4.ddpfPixelFormat, Mode.Format);
2391         }
2392     }
2393
2394     /* No Width or no Height? Use the original screen size
2395      */
2396     if(!(desc2.dwFlags & DDSD_WIDTH) ||
2397        !(desc2.dwFlags & DDSD_HEIGHT) )
2398     {
2399         /* Invalid for non-render targets */
2400         if(!(desc2.ddsCaps.dwCaps & DDSCAPS_PRIMARYSURFACE))
2401         {
2402             WARN("Creating a non-Primary surface without Width or Height info, returning DDERR_INVALIDPARAMS\n");
2403             *Surf = NULL;
2404             LeaveCriticalSection(&ddraw_cs);
2405             return DDERR_INVALIDPARAMS;
2406         }
2407
2408         desc2.dwFlags |= DDSD_WIDTH | DDSD_HEIGHT;
2409         desc2.dwWidth = Mode.Width;
2410         desc2.dwHeight = Mode.Height;
2411     }
2412
2413     /* Mipmap count fixes */
2414     if(desc2.ddsCaps.dwCaps & DDSCAPS_MIPMAP)
2415     {
2416         if(desc2.ddsCaps.dwCaps & DDSCAPS_COMPLEX)
2417         {
2418             if(desc2.dwFlags & DDSD_MIPMAPCOUNT)
2419             {
2420                 /* Mipmap count is given, should not be 0 */
2421                 if( desc2.u2.dwMipMapCount == 0 )
2422                 {
2423                     LeaveCriticalSection(&ddraw_cs);
2424                     return DDERR_INVALIDPARAMS;
2425                 }
2426             }
2427             else
2428             {
2429                 /* Undocumented feature: Create sublevels until
2430                  * either the width or the height is 1
2431                  */
2432                 DWORD min = desc2.dwWidth < desc2.dwHeight ?
2433                             desc2.dwWidth : desc2.dwHeight;
2434                 desc2.u2.dwMipMapCount = 0;
2435                 while( min )
2436                 {
2437                     desc2.u2.dwMipMapCount += 1;
2438                     min >>= 1;
2439                 }
2440             }
2441         }
2442         else
2443         {
2444             /* Not-complex mipmap -> Mipmapcount = 1 */
2445             desc2.u2.dwMipMapCount = 1;
2446         }
2447         extra_surfaces = desc2.u2.dwMipMapCount - 1;
2448
2449         /* There's a mipmap count in the created surface in any case */
2450         desc2.dwFlags |= DDSD_MIPMAPCOUNT;
2451     }
2452     /* If no mipmap is given, the texture has only one level */
2453
2454     /* The first surface is a front buffer, the back buffer is created afterwards */
2455     if( (desc2.dwFlags & DDSD_CAPS) && (desc2.ddsCaps.dwCaps & DDSCAPS_PRIMARYSURFACE) )
2456     {
2457         desc2.ddsCaps.dwCaps |= DDSCAPS_FRONTBUFFER;
2458     }
2459
2460     /* The root surface in a cube map is positive x */
2461     if(desc2.ddsCaps.dwCaps2 & DDSCAPS2_CUBEMAP)
2462     {
2463         desc2.ddsCaps.dwCaps2 &= ~DDSCAPS2_CUBEMAP_ALLFACES;
2464         desc2.ddsCaps.dwCaps2 |=  DDSCAPS2_CUBEMAP_POSITIVEX;
2465     }
2466
2467     /* Create the first surface */
2468     hr = IDirectDrawImpl_CreateNewSurface(This, &desc2, &object, 0);
2469     if( hr != DD_OK)
2470     {
2471         ERR("IDirectDrawImpl_CreateNewSurface failed with %08x\n", hr);
2472         LeaveCriticalSection(&ddraw_cs);
2473         return hr;
2474     }
2475     object->is_complex_root = TRUE;
2476
2477     *Surf = ICOM_INTERFACE(object, IDirectDrawSurface7);
2478
2479     /* Create Additional surfaces if necessary
2480      * This applies to Primary surfaces which have a back buffer count
2481      * set, but not to mipmap textures. In case of Mipmap textures,
2482      * wineD3D takes care of the creation of additional surfaces
2483      */
2484     if(DDSD->dwFlags & DDSD_BACKBUFFERCOUNT)
2485     {
2486         extra_surfaces = DDSD->dwBackBufferCount;
2487         desc2.ddsCaps.dwCaps &= ~DDSCAPS_FRONTBUFFER; /* It's not a front buffer */
2488         desc2.ddsCaps.dwCaps |= DDSCAPS_BACKBUFFER;
2489     }
2490
2491     hr = DD_OK;
2492     if(desc2.ddsCaps.dwCaps2 & DDSCAPS2_CUBEMAP)
2493     {
2494         desc2.ddsCaps.dwCaps2 &= ~DDSCAPS2_CUBEMAP_ALLFACES;
2495         desc2.ddsCaps.dwCaps2 |=  DDSCAPS2_CUBEMAP_NEGATIVEZ;
2496         hr |= CreateAdditionalSurfaces(This, object, extra_surfaces + 1, desc2, TRUE);
2497         desc2.ddsCaps.dwCaps2 &= ~DDSCAPS2_CUBEMAP_NEGATIVEZ;
2498         desc2.ddsCaps.dwCaps2 |=  DDSCAPS2_CUBEMAP_POSITIVEZ;
2499         hr |= CreateAdditionalSurfaces(This, object, extra_surfaces + 1, desc2, TRUE);
2500         desc2.ddsCaps.dwCaps2 &= ~DDSCAPS2_CUBEMAP_POSITIVEZ;
2501         desc2.ddsCaps.dwCaps2 |=  DDSCAPS2_CUBEMAP_NEGATIVEY;
2502         hr |= CreateAdditionalSurfaces(This, object, extra_surfaces + 1, desc2, TRUE);
2503         desc2.ddsCaps.dwCaps2 &= ~DDSCAPS2_CUBEMAP_NEGATIVEY;
2504         desc2.ddsCaps.dwCaps2 |=  DDSCAPS2_CUBEMAP_POSITIVEY;
2505         hr |= CreateAdditionalSurfaces(This, object, extra_surfaces + 1, desc2, TRUE);
2506         desc2.ddsCaps.dwCaps2 &= ~DDSCAPS2_CUBEMAP_POSITIVEY;
2507         desc2.ddsCaps.dwCaps2 |=  DDSCAPS2_CUBEMAP_NEGATIVEX;
2508         hr |= CreateAdditionalSurfaces(This, object, extra_surfaces + 1, desc2, TRUE);
2509         desc2.ddsCaps.dwCaps2 &= ~DDSCAPS2_CUBEMAP_NEGATIVEX;
2510         desc2.ddsCaps.dwCaps2 |=  DDSCAPS2_CUBEMAP_POSITIVEX;
2511     }
2512
2513     hr |= CreateAdditionalSurfaces(This, object, extra_surfaces, desc2, FALSE);
2514     if(hr != DD_OK)
2515     {
2516         /* This destroys and possibly created surfaces too */
2517         IDirectDrawSurface_Release( ICOM_INTERFACE(object, IDirectDrawSurface7) );
2518         LeaveCriticalSection(&ddraw_cs);
2519         return hr;
2520     }
2521
2522     /* If the implementation is OpenGL and there's no d3ddevice, attach a d3ddevice
2523      * But attach the d3ddevice only if the currently created surface was
2524      * a primary surface (2D app in 3D mode) or a 3DDEVICE surface (3D app)
2525      * The only case I can think of where this doesn't apply is when a
2526      * 2D app was configured by the user to run with OpenGL and it didn't create
2527      * the render target as first surface. In this case the render target creation
2528      * will cause the 3D init.
2529      */
2530     if( (This->ImplType == SURFACE_OPENGL) && !(This->d3d_initialized) &&
2531         desc2.ddsCaps.dwCaps & (DDSCAPS_PRIMARYSURFACE | DDSCAPS_3DDEVICE) )
2532     {
2533         IDirectDrawSurfaceImpl *target = object, *surface;
2534         struct list *entry;
2535
2536         /* Search for the primary to use as render target */
2537         LIST_FOR_EACH(entry, &This->surface_list)
2538         {
2539             surface = LIST_ENTRY(entry, IDirectDrawSurfaceImpl, surface_list_entry);
2540             if((surface->surface_desc.ddsCaps.dwCaps & (DDSCAPS_PRIMARYSURFACE | DDSCAPS_FRONTBUFFER)) ==
2541                (DDSCAPS_PRIMARYSURFACE | DDSCAPS_FRONTBUFFER))
2542             {
2543                 /* found */
2544                 target = surface;
2545                 TRACE("Using primary %p as render target\n", target);
2546                 break;
2547             }
2548         }
2549
2550         TRACE("(%p) Attaching a D3DDevice, rendertarget = %p\n", This, target);
2551         hr = IDirectDrawImpl_AttachD3DDevice(This, target);
2552         if(hr != D3D_OK)
2553         {
2554             IDirectDrawSurfaceImpl *release_surf;
2555             ERR("IDirectDrawImpl_AttachD3DDevice failed, hr = %x\n", hr);
2556             *Surf = NULL;
2557
2558             /* The before created surface structures are in an incomplete state here.
2559              * WineD3D holds the reference on the IParents, and it released them on the failure
2560              * already. So the regular release method implementation would fail on the attempt
2561              * to destroy either the IParents or the swapchain. So free the surface here.
2562              * The surface structure here is a list, not a tree, because onscreen targets
2563              * cannot be cube textures
2564              */
2565             while(object)
2566             {
2567                 release_surf = object;
2568                 object = object->complex_array[0];
2569                 IDirectDrawSurfaceImpl_Destroy(release_surf);
2570             }
2571             LeaveCriticalSection(&ddraw_cs);
2572             return hr;
2573         }
2574     }
2575
2576     /* Addref the ddraw interface to keep an reference for each surface */
2577     IDirectDraw7_AddRef(iface);
2578     object->ifaceToRelease = (IUnknown *) iface;
2579
2580     /* Create a WineD3DTexture if a texture was requested */
2581     if(desc2.ddsCaps.dwCaps & DDSCAPS_TEXTURE)
2582     {
2583         UINT levels;
2584         WINED3DFORMAT Format;
2585         WINED3DPOOL Pool = WINED3DPOOL_DEFAULT;
2586
2587         This->tex_root = object;
2588
2589         if(desc2.ddsCaps.dwCaps & DDSCAPS_MIPMAP)
2590         {
2591             /* a mipmap is created, create enough levels */
2592             levels = desc2.u2.dwMipMapCount;
2593         }
2594         else
2595         {
2596             /* No mipmap is created, create one level */
2597             levels = 1;
2598         }
2599
2600         /* DDSCAPS_SYSTEMMEMORY textures are in WINED3DPOOL_SYSTEMMEM */
2601         if(DDSD->ddsCaps.dwCaps & DDSCAPS_SYSTEMMEMORY)
2602         {
2603             Pool = WINED3DPOOL_SYSTEMMEM;
2604         }
2605         /* Should I forward the MANEGED cap to the managed pool ? */
2606
2607         /* Get the format. It's set already by CreateNewSurface */
2608         Format = PixelFormat_DD2WineD3D(&object->surface_desc.u4.ddpfPixelFormat);
2609
2610         /* The surfaces are already created, the callback only
2611          * passes the IWineD3DSurface to WineD3D
2612          */
2613         if(desc2.ddsCaps.dwCaps2 & DDSCAPS2_CUBEMAP)
2614         {
2615             hr = IWineD3DDevice_CreateCubeTexture(This->wineD3DDevice,
2616                                                   DDSD->dwWidth, /* Edgelength */
2617                                                   levels,
2618                                                   0, /* usage */
2619                                                   Format,
2620                                                   Pool,
2621                                                   (IWineD3DCubeTexture **) &object->wineD3DTexture,
2622                                                   0, /* SharedHandle */
2623                                                   (IUnknown *) ICOM_INTERFACE(object, IDirectDrawSurface7),
2624                                                   D3D7CB_CreateSurface);
2625         }
2626         else
2627         {
2628             hr = IWineD3DDevice_CreateTexture(This->wineD3DDevice,
2629                                               DDSD->dwWidth, DDSD->dwHeight,
2630                                               levels, /* MipMapCount = Levels */
2631                                               0, /* usage */
2632                                               Format,
2633                                               Pool,
2634                                               (IWineD3DTexture **) &object->wineD3DTexture,
2635                                               0, /* SharedHandle */
2636                                               (IUnknown *) ICOM_INTERFACE(object, IDirectDrawSurface7),
2637                                               D3D7CB_CreateSurface );
2638         }
2639         This->tex_root = NULL;
2640     }
2641
2642     LeaveCriticalSection(&ddraw_cs);
2643     return hr;
2644 }
2645
2646 #define DDENUMSURFACES_SEARCHTYPE (DDENUMSURFACES_CANBECREATED|DDENUMSURFACES_DOESEXIST)
2647 #define DDENUMSURFACES_MATCHTYPE (DDENUMSURFACES_ALL|DDENUMSURFACES_MATCH|DDENUMSURFACES_NOMATCH)
2648
2649 static BOOL
2650 Main_DirectDraw_DDPIXELFORMAT_Match(const DDPIXELFORMAT *requested,
2651                                     const DDPIXELFORMAT *provided)
2652 {
2653     /* Some flags must be present in both or neither for a match. */
2654     static const DWORD must_match = DDPF_PALETTEINDEXED1 | DDPF_PALETTEINDEXED2
2655         | DDPF_PALETTEINDEXED4 | DDPF_PALETTEINDEXED8 | DDPF_FOURCC
2656         | DDPF_ZBUFFER | DDPF_STENCILBUFFER;
2657
2658     if ((requested->dwFlags & provided->dwFlags) != requested->dwFlags)
2659         return FALSE;
2660
2661     if ((requested->dwFlags & must_match) != (provided->dwFlags & must_match))
2662         return FALSE;
2663
2664     if (requested->dwFlags & DDPF_FOURCC)
2665         if (requested->dwFourCC != provided->dwFourCC)
2666             return FALSE;
2667
2668     if (requested->dwFlags & (DDPF_RGB|DDPF_YUV|DDPF_ZBUFFER|DDPF_ALPHA
2669                               |DDPF_LUMINANCE|DDPF_BUMPDUDV))
2670         if (requested->u1.dwRGBBitCount != provided->u1.dwRGBBitCount)
2671             return FALSE;
2672
2673     if (requested->dwFlags & (DDPF_RGB|DDPF_YUV|DDPF_STENCILBUFFER
2674                               |DDPF_LUMINANCE|DDPF_BUMPDUDV))
2675         if (requested->u2.dwRBitMask != provided->u2.dwRBitMask)
2676             return FALSE;
2677
2678     if (requested->dwFlags & (DDPF_RGB|DDPF_YUV|DDPF_ZBUFFER|DDPF_BUMPDUDV))
2679         if (requested->u3.dwGBitMask != provided->u3.dwGBitMask)
2680             return FALSE;
2681
2682     /* I could be wrong about the bumpmapping. MSDN docs are vague. */
2683     if (requested->dwFlags & (DDPF_RGB|DDPF_YUV|DDPF_STENCILBUFFER
2684                               |DDPF_BUMPDUDV))
2685         if (requested->u4.dwBBitMask != provided->u4.dwBBitMask)
2686             return FALSE;
2687
2688     if (requested->dwFlags & (DDPF_ALPHAPIXELS|DDPF_ZPIXELS))
2689         if (requested->u5.dwRGBAlphaBitMask != provided->u5.dwRGBAlphaBitMask)
2690             return FALSE;
2691
2692     return TRUE;
2693 }
2694
2695 static BOOL
2696 IDirectDrawImpl_DDSD_Match(const DDSURFACEDESC2* requested,
2697                            const DDSURFACEDESC2* provided)
2698 {
2699     struct compare_info
2700     {
2701         DWORD flag;
2702         ptrdiff_t offset;
2703         size_t size;
2704     };
2705
2706 #define CMP(FLAG, FIELD)                                \
2707         { DDSD_##FLAG, offsetof(DDSURFACEDESC2, FIELD), \
2708           sizeof(((DDSURFACEDESC2 *)(NULL))->FIELD) }
2709
2710     static const struct compare_info compare[] =
2711     {
2712         CMP(ALPHABITDEPTH, dwAlphaBitDepth),
2713         CMP(BACKBUFFERCOUNT, dwBackBufferCount),
2714         CMP(CAPS, ddsCaps),
2715         CMP(CKDESTBLT, ddckCKDestBlt),
2716         CMP(CKDESTOVERLAY, u3 /* ddckCKDestOverlay */),
2717         CMP(CKSRCBLT, ddckCKSrcBlt),
2718         CMP(CKSRCOVERLAY, ddckCKSrcOverlay),
2719         CMP(HEIGHT, dwHeight),
2720         CMP(LINEARSIZE, u1 /* dwLinearSize */),
2721         CMP(LPSURFACE, lpSurface),
2722         CMP(MIPMAPCOUNT, u2 /* dwMipMapCount */),
2723         CMP(PITCH, u1 /* lPitch */),
2724         /* PIXELFORMAT: manual */
2725         CMP(REFRESHRATE, u2 /* dwRefreshRate */),
2726         CMP(TEXTURESTAGE, dwTextureStage),
2727         CMP(WIDTH, dwWidth),
2728         /* ZBUFFERBITDEPTH: "obsolete" */
2729     };
2730
2731 #undef CMP
2732
2733     unsigned int i;
2734
2735     if ((requested->dwFlags & provided->dwFlags) != requested->dwFlags)
2736         return FALSE;
2737
2738     for (i=0; i < sizeof(compare)/sizeof(compare[0]); i++)
2739     {
2740         if (requested->dwFlags & compare[i].flag
2741             && memcmp((const char *)provided + compare[i].offset,
2742                       (const char *)requested + compare[i].offset,
2743                       compare[i].size) != 0)
2744             return FALSE;
2745     }
2746
2747     if (requested->dwFlags & DDSD_PIXELFORMAT)
2748     {
2749         if (!Main_DirectDraw_DDPIXELFORMAT_Match(&requested->u4.ddpfPixelFormat,
2750                                                 &provided->u4.ddpfPixelFormat))
2751             return FALSE;
2752     }
2753
2754     return TRUE;
2755 }
2756
2757 #undef DDENUMSURFACES_SEARCHTYPE
2758 #undef DDENUMSURFACES_MATCHTYPE
2759
2760 /*****************************************************************************
2761  * IDirectDraw7::EnumSurfaces
2762  *
2763  * Loops through all surfaces attached to this device and calls the
2764  * application callback. This can't be relayed to WineD3DDevice,
2765  * because some WineD3DSurfaces' parents are IParent objects
2766  *
2767  * Params:
2768  *  Flags: Some filtering flags. See IDirectDrawImpl_EnumSurfacesCallback
2769  *  DDSD: Description to filter for
2770  *  Context: Application-provided pointer, it's passed unmodified to the
2771  *           Callback function
2772  *  Callback: Address to call for each surface
2773  *
2774  * Returns:
2775  *  DDERR_INVALIDPARAMS if the callback is NULL
2776  *  DD_OK on success
2777  *
2778  *****************************************************************************/
2779 static HRESULT WINAPI
2780 IDirectDrawImpl_EnumSurfaces(IDirectDraw7 *iface,
2781                              DWORD Flags,
2782                              DDSURFACEDESC2 *DDSD,
2783                              void *Context,
2784                              LPDDENUMSURFACESCALLBACK7 Callback)
2785 {
2786     /* The surface enumeration is handled by WineDDraw,
2787      * because it keeps track of all surfaces attached to
2788      * it. The filtering is done by our callback function,
2789      * because WineDDraw doesn't handle ddraw-like surface
2790      * caps structures
2791      */
2792     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
2793     IDirectDrawSurfaceImpl *surf;
2794     BOOL all, nomatch;
2795     DDSURFACEDESC2 desc;
2796     struct list *entry, *entry2;
2797
2798     all = Flags & DDENUMSURFACES_ALL;
2799     nomatch = Flags & DDENUMSURFACES_NOMATCH;
2800
2801     TRACE("(%p)->(%x,%p,%p,%p)\n", This, Flags, DDSD, Context, Callback);
2802     EnterCriticalSection(&ddraw_cs);
2803
2804     if(!Callback)
2805     {
2806         LeaveCriticalSection(&ddraw_cs);
2807         return DDERR_INVALIDPARAMS;
2808     }
2809
2810     /* Use the _SAFE enumeration, the app may destroy enumerated surfaces */
2811     LIST_FOR_EACH_SAFE(entry, entry2, &This->surface_list)
2812     {
2813         surf = LIST_ENTRY(entry, IDirectDrawSurfaceImpl, surface_list_entry);
2814         if (all || (nomatch != IDirectDrawImpl_DDSD_Match(DDSD, &surf->surface_desc)))
2815         {
2816             desc = surf->surface_desc;
2817             IDirectDrawSurface7_AddRef(ICOM_INTERFACE(surf, IDirectDrawSurface7));
2818             if(Callback( ICOM_INTERFACE(surf, IDirectDrawSurface7), &desc, Context) != DDENUMRET_OK)
2819             {
2820                 LeaveCriticalSection(&ddraw_cs);
2821                 return DD_OK;
2822             }
2823         }
2824     }
2825     LeaveCriticalSection(&ddraw_cs);
2826     return DD_OK;
2827 }
2828
2829 static HRESULT WINAPI
2830 findRenderTarget(IDirectDrawSurface7 *surface,
2831                  DDSURFACEDESC2 *desc,
2832                  void *ctx)
2833 {
2834     IDirectDrawSurfaceImpl *surf = ICOM_OBJECT(IDirectDrawSurfaceImpl, IDirectDrawSurface7, surface);
2835     IDirectDrawSurfaceImpl **target = (IDirectDrawSurfaceImpl **) ctx;
2836
2837     if(!surf->isRenderTarget) {
2838         *target = surf;
2839         IDirectDrawSurface7_Release(surface);
2840         return DDENUMRET_CANCEL;
2841     }
2842
2843     /* Recurse into the surface tree */
2844     IDirectDrawSurface7_EnumAttachedSurfaces(surface, ctx, findRenderTarget);
2845
2846     IDirectDrawSurface7_Release(surface);
2847     if(*target) return DDENUMRET_CANCEL;
2848     else return DDENUMRET_OK; /* Continue with the next neighbor surface */
2849 }
2850
2851 /*****************************************************************************
2852  * D3D7CB_CreateRenderTarget
2853  *
2854  * Callback called by WineD3D to create Surfaces for render target usage
2855  * This function takes the D3D target from the IDirectDrawImpl structure,
2856  * and returns the WineD3DSurface. To avoid double usage, the surface
2857  * is marked as render target afterwards
2858  *
2859  * Params
2860  *  device: The WineD3DDevice's parent
2861  *  Width, Height, Format: Dimensions and pixelformat of the render target
2862  *                         Ignored, because the surface already exists
2863  *  MultiSample, MultisampleQuality, Lockable: Ignored for the same reason
2864  *  Lockable: ignored
2865  *  ppSurface: Address to pass the surface pointer back at
2866  *  pSharedHandle: Ignored
2867  *
2868  * Returns:
2869  *  Always returns D3D_OK
2870  *
2871  *****************************************************************************/
2872 static HRESULT WINAPI
2873 D3D7CB_CreateRenderTarget(IUnknown *device, IUnknown *pSuperior,
2874                           UINT Width, UINT Height,
2875                           WINED3DFORMAT Format,
2876                           WINED3DMULTISAMPLE_TYPE MultiSample,
2877                           DWORD MultisampleQuality,
2878                           BOOL Lockable,
2879                           IWineD3DSurface** ppSurface,
2880                           HANDLE* pSharedHandle)
2881 {
2882     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, device);
2883     IDirectDrawSurfaceImpl *d3dSurface = This->d3d_target, *target = NULL;
2884     TRACE("(%p) call back\n", device);
2885
2886     if(d3dSurface->isRenderTarget)
2887     {
2888         IDirectDrawSurface7_EnumAttachedSurfaces(ICOM_INTERFACE(d3dSurface, IDirectDrawSurface7),
2889                                                  &target, findRenderTarget);
2890     }
2891     else
2892     {
2893         target = d3dSurface;
2894     }
2895
2896     if(!target)
2897     {
2898         target = This->d3d_target;
2899         ERR(" (%p) : No DirectDrawSurface found to create the back buffer. Using the front buffer as back buffer. Uncertain consequences\n", This);
2900     }
2901
2902     /* TODO: Return failure if the dimensions do not match, but this shouldn't happen */
2903
2904     *ppSurface = target->WineD3DSurface;
2905     target->isRenderTarget = TRUE;
2906     TRACE("Returning wineD3DSurface %p, it belongs to surface %p\n", *ppSurface, d3dSurface);
2907     return D3D_OK;
2908 }
2909
2910 static HRESULT WINAPI
2911 D3D7CB_CreateDepthStencilSurface(IUnknown *device,
2912                                  IUnknown *pSuperior,
2913                                  UINT Width,
2914                                  UINT Height,
2915                                  WINED3DFORMAT Format,
2916                                  WINED3DMULTISAMPLE_TYPE MultiSample,
2917                                  DWORD MultisampleQuality,
2918                                  BOOL Discard,
2919                                  IWineD3DSurface** ppSurface,
2920                                  HANDLE* pSharedHandle)
2921 {
2922     /* Create a Depth Stencil surface to make WineD3D happy */
2923     HRESULT hr = D3D_OK;
2924     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, device);
2925     DDSURFACEDESC2 ddsd;
2926
2927     TRACE("(%p) call back\n", device);
2928
2929     *ppSurface = NULL;
2930
2931     /* Create a DirectDraw surface */
2932     memset(&ddsd, 0, sizeof(ddsd));
2933     ddsd.dwSize = sizeof(ddsd);
2934     ddsd.u4.ddpfPixelFormat.dwSize = sizeof(DDPIXELFORMAT);
2935     ddsd.dwFlags = DDSD_PIXELFORMAT | DDSD_WIDTH | DDSD_HEIGHT | DDSD_CAPS;
2936     ddsd.ddsCaps.dwCaps = DDSCAPS_OFFSCREENPLAIN;
2937     ddsd.dwHeight = Height;
2938     ddsd.dwWidth = Width;
2939     if(Format != 0)
2940     {
2941       PixelFormat_WineD3DtoDD(&ddsd.u4.ddpfPixelFormat, Format);
2942     }
2943     else
2944     {
2945       ddsd.dwFlags ^= DDSD_PIXELFORMAT;
2946     }
2947
2948     This->depthstencil = TRUE;
2949     hr = IDirectDraw7_CreateSurface((IDirectDraw7 *) This,
2950                                     &ddsd,
2951                                     (IDirectDrawSurface7 **) &This->DepthStencilBuffer,
2952                                     NULL);
2953     This->depthstencil = FALSE;
2954     if(FAILED(hr))
2955     {
2956         ERR(" (%p) Creating a DepthStencil Surface failed, result = %x\n", This, hr);
2957         return hr;
2958     }
2959     *ppSurface = This->DepthStencilBuffer->WineD3DSurface;
2960     return D3D_OK;
2961 }
2962
2963 /*****************************************************************************
2964  * D3D7CB_CreateAdditionalSwapChain
2965  *
2966  * Callback function for WineD3D which creates a new WineD3DSwapchain
2967  * interface. It also creates an IParent interface to store that pointer,
2968  * so the WineD3DSwapchain has a parent and can be released when the D3D
2969  * device is destroyed
2970  *****************************************************************************/
2971 static HRESULT WINAPI
2972 D3D7CB_CreateAdditionalSwapChain(IUnknown *device,
2973                                  WINED3DPRESENT_PARAMETERS* pPresentationParameters,
2974                                  IWineD3DSwapChain ** ppSwapChain)
2975 {
2976     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, device);
2977     IParentImpl *object = NULL;
2978     HRESULT res = D3D_OK;
2979     IWineD3DSwapChain *swapchain;
2980     TRACE("(%p) call back\n", device);
2981
2982     object = HeapAlloc(GetProcessHeap(),  HEAP_ZERO_MEMORY, sizeof(IParentImpl));
2983     if (NULL == object)
2984     {
2985         FIXME("Allocation of memory failed\n");
2986         *ppSwapChain = NULL;
2987         return DDERR_OUTOFVIDEOMEMORY;
2988     }
2989
2990     ICOM_INIT_INTERFACE(object, IParent, IParent_Vtbl);
2991     object->ref = 1;
2992
2993     res = IWineD3DDevice_CreateAdditionalSwapChain(This->wineD3DDevice,
2994                                                    pPresentationParameters,
2995                                                    &swapchain,
2996                                                    (IUnknown*) ICOM_INTERFACE(object, IParent),
2997                                                    D3D7CB_CreateRenderTarget,
2998                                                    D3D7CB_CreateDepthStencilSurface);
2999     if (res != D3D_OK)
3000     {
3001         FIXME("(%p) call to IWineD3DDevice_CreateAdditionalSwapChain failed\n", This);
3002         HeapFree(GetProcessHeap(), 0 , object);
3003         *ppSwapChain = NULL;
3004     }
3005     else
3006     {
3007         *ppSwapChain = swapchain;
3008         object->child = (IUnknown *) swapchain;
3009     }
3010
3011     return res;
3012 }
3013
3014 /*****************************************************************************
3015  * IDirectDrawImpl_AttachD3DDevice
3016  *
3017  * Initializes the D3D capabilities of WineD3D
3018  *
3019  * Params:
3020  *  primary: The primary surface for D3D
3021  *
3022  * Returns
3023  *  DD_OK on success,
3024  *  DDERR_* otherwise
3025  *
3026  *****************************************************************************/
3027 static HRESULT WINAPI
3028 IDirectDrawImpl_AttachD3DDevice(IDirectDrawImpl *This,
3029                                 IDirectDrawSurfaceImpl *primary)
3030 {
3031     HRESULT hr;
3032     HWND                  window;
3033
3034     WINED3DPRESENT_PARAMETERS localParameters;
3035
3036     TRACE("(%p)->(%p)\n", This, primary);
3037
3038     /* Get the window */
3039     hr = IWineD3DDevice_GetHWND(This->wineD3DDevice,
3040                                 &window);
3041     if(hr != D3D_OK)
3042     {
3043         ERR("IWineD3DDevice::GetHWND failed\n");
3044         return hr;
3045     }
3046
3047     /* If there's no window, create a hidden window. WineD3D needs it */
3048     if(window == 0)
3049     {
3050         window = CreateWindowExA(0, This->classname, "Hidden D3D Window",
3051                                  WS_DISABLED, 0, 0,
3052                                  GetSystemMetrics(SM_CXSCREEN),
3053                                  GetSystemMetrics(SM_CYSCREEN),
3054                                  NULL, NULL, GetModuleHandleA(0), NULL);
3055
3056         ShowWindow(window, SW_HIDE);   /* Just to be sure */
3057         WARN("(%p) No window for the Direct3DDevice, created a hidden window. HWND=%p\n", This, window);
3058         This->d3d_window = window;
3059     }
3060     else
3061     {
3062         TRACE("(%p) Using existing window %p for Direct3D rendering\n", This, window);
3063     }
3064
3065     /* Store the future Render Target surface */
3066     This->d3d_target = primary;
3067
3068     /* Use the surface description for the device parameters, not the
3069      * Device settings. The app might render to an offscreen surface
3070      */
3071     localParameters.BackBufferWidth                 = primary->surface_desc.dwWidth;
3072     localParameters.BackBufferHeight                = primary->surface_desc.dwHeight;
3073     localParameters.BackBufferFormat                = PixelFormat_DD2WineD3D(&primary->surface_desc.u4.ddpfPixelFormat);
3074     localParameters.BackBufferCount                 = (primary->surface_desc.dwFlags & DDSD_BACKBUFFERCOUNT) ? primary->surface_desc.dwBackBufferCount : 0;
3075     localParameters.MultiSampleType                 = WINED3DMULTISAMPLE_NONE;
3076     localParameters.MultiSampleQuality              = 0;
3077     localParameters.SwapEffect                      = WINED3DSWAPEFFECT_COPY;
3078     localParameters.hDeviceWindow                   = window;
3079     localParameters.Windowed                        = !(This->cooperative_level & DDSCL_FULLSCREEN);
3080     localParameters.EnableAutoDepthStencil          = FALSE;
3081     localParameters.AutoDepthStencilFormat          = WINED3DFMT_D16;
3082     localParameters.Flags                           = 0;
3083     localParameters.FullScreen_RefreshRateInHz      = WINED3DPRESENT_RATE_DEFAULT; /* Default rate: It's already set */
3084     localParameters.PresentationInterval            = WINED3DPRESENT_INTERVAL_DEFAULT;
3085
3086     TRACE("Passing mode %d\n", localParameters.BackBufferFormat);
3087
3088     /* Set this NOW, otherwise creating the depth stencil surface will cause a
3089      * recursive loop until ram or emulated video memory is full
3090      */
3091     This->d3d_initialized = TRUE;
3092
3093     hr = IWineD3DDevice_Init3D(This->wineD3DDevice,
3094                                &localParameters,
3095                                D3D7CB_CreateAdditionalSwapChain);
3096     if(FAILED(hr))
3097     {
3098         This->d3d_target = NULL;
3099         This->d3d_initialized = FALSE;
3100         return hr;
3101     }
3102
3103     This->declArraySize = 2;
3104     This->decls = HeapAlloc(GetProcessHeap(),
3105                             HEAP_ZERO_MEMORY,
3106                             sizeof(*This->decls) * This->declArraySize);
3107     if(!This->decls)
3108     {
3109         ERR("Error allocating an array for the converted vertex decls\n");
3110         This->declArraySize = 0;
3111         hr = IWineD3DDevice_Uninit3D(This->wineD3DDevice,
3112                                      D3D7CB_DestroyDepthStencilSurface,
3113                                      D3D7CB_DestroySwapChain);
3114         return E_OUTOFMEMORY;
3115     }
3116
3117     /* Create an Index Buffer parent */
3118     TRACE("(%p) Successfully initialized 3D\n", This);
3119     return DD_OK;
3120 }
3121
3122 /*****************************************************************************
3123  * DirectDrawCreateClipper (DDRAW.@)
3124  *
3125  * Creates a new IDirectDrawClipper object.
3126  *
3127  * Params:
3128  *  Clipper: Address to write the interface pointer to
3129  *  UnkOuter: For aggregation support, which ddraw doesn't have. Has to be
3130  *            NULL
3131  *
3132  * Returns:
3133  *  CLASS_E_NOAGGREGATION if UnkOuter != NULL
3134  *  E_OUTOFMEMORY if allocating the object failed
3135  *
3136  *****************************************************************************/
3137 HRESULT WINAPI
3138 DirectDrawCreateClipper(DWORD Flags,
3139                         LPDIRECTDRAWCLIPPER *Clipper,
3140                         IUnknown *UnkOuter)
3141 {
3142     IDirectDrawClipperImpl* object;
3143     TRACE("(%08x,%p,%p)\n", Flags, Clipper, UnkOuter);
3144
3145     EnterCriticalSection(&ddraw_cs);
3146     if (UnkOuter != NULL)
3147     {
3148         LeaveCriticalSection(&ddraw_cs);
3149         return CLASS_E_NOAGGREGATION;
3150     }
3151
3152     object = HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY,
3153                      sizeof(IDirectDrawClipperImpl));
3154     if (object == NULL)
3155     {
3156         LeaveCriticalSection(&ddraw_cs);
3157         return E_OUTOFMEMORY;
3158     }
3159
3160     ICOM_INIT_INTERFACE(object, IDirectDrawClipper, IDirectDrawClipper_Vtbl);
3161     object->ref = 1;
3162     object->wineD3DClipper = pWineDirect3DCreateClipper((IUnknown *) object);
3163     if(!object->wineD3DClipper)
3164     {
3165         HeapFree(GetProcessHeap(), 0, object);
3166         LeaveCriticalSection(&ddraw_cs);
3167         return E_OUTOFMEMORY;
3168     }
3169
3170     *Clipper = (IDirectDrawClipper *) object;
3171     LeaveCriticalSection(&ddraw_cs);
3172     return DD_OK;
3173 }
3174
3175 /*****************************************************************************
3176  * IDirectDraw7::CreateClipper
3177  *
3178  * Creates a DDraw clipper. See DirectDrawCreateClipper for details
3179  *
3180  *****************************************************************************/
3181 static HRESULT WINAPI
3182 IDirectDrawImpl_CreateClipper(IDirectDraw7 *iface,
3183                               DWORD Flags,
3184                               IDirectDrawClipper **Clipper,
3185                               IUnknown *UnkOuter)
3186 {
3187     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
3188     TRACE("(%p)->(%x,%p,%p)\n", This, Flags, Clipper, UnkOuter);
3189     return DirectDrawCreateClipper(Flags, Clipper, UnkOuter);
3190 }
3191
3192 /*****************************************************************************
3193  * IDirectDraw7::CreatePalette
3194  *
3195  * Creates a new IDirectDrawPalette object
3196  *
3197  * Params:
3198  *  Flags: The flags for the new clipper
3199  *  ColorTable: Color table to assign to the new clipper
3200  *  Palette: Address to write the interface pointer to
3201  *  UnkOuter: For aggregation support, which ddraw doesn't have. Has to be
3202  *            NULL
3203  *
3204  * Returns:
3205  *  CLASS_E_NOAGGREGATION if UnkOuter != NULL
3206  *  E_OUTOFMEMORY if allocating the object failed
3207  *
3208  *****************************************************************************/
3209 static HRESULT WINAPI
3210 IDirectDrawImpl_CreatePalette(IDirectDraw7 *iface,
3211                               DWORD Flags,
3212                               PALETTEENTRY *ColorTable,
3213                               IDirectDrawPalette **Palette,
3214                               IUnknown *pUnkOuter)
3215 {
3216     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
3217     IDirectDrawPaletteImpl *object;
3218     HRESULT hr = DDERR_GENERIC;
3219     TRACE("(%p)->(%x,%p,%p,%p)\n", This, Flags, ColorTable, Palette, pUnkOuter);
3220
3221     EnterCriticalSection(&ddraw_cs);
3222     if(pUnkOuter != NULL)
3223     {
3224         WARN("pUnkOuter is %p, returning CLASS_E_NOAGGREGATION\n", pUnkOuter);
3225         LeaveCriticalSection(&ddraw_cs);
3226         return CLASS_E_NOAGGREGATION;
3227     }
3228
3229     /* The refcount test shows that a cooplevel is required for this */
3230     if(!This->cooperative_level)
3231     {
3232         WARN("No cooperative level set, returning DDERR_NOCOOPERATIVELEVELSET\n");
3233         LeaveCriticalSection(&ddraw_cs);
3234         return DDERR_NOCOOPERATIVELEVELSET;
3235     }
3236
3237     object = HeapAlloc(GetProcessHeap(), 0, sizeof(IDirectDrawPaletteImpl));
3238     if(!object)
3239     {
3240         ERR("Out of memory when allocating memory for a palette implementation\n");
3241         LeaveCriticalSection(&ddraw_cs);
3242         return E_OUTOFMEMORY;
3243     }
3244
3245     ICOM_INIT_INTERFACE(object, IDirectDrawPalette, IDirectDrawPalette_Vtbl);
3246     object->ref = 1;
3247     object->ddraw_owner = This;
3248
3249     hr = IWineD3DDevice_CreatePalette(This->wineD3DDevice, Flags, ColorTable, &object->wineD3DPalette, (IUnknown *) ICOM_INTERFACE(object, IDirectDrawPalette) );
3250     if(hr != DD_OK)
3251     {
3252         HeapFree(GetProcessHeap(), 0, object);
3253         LeaveCriticalSection(&ddraw_cs);
3254         return hr;
3255     }
3256
3257     IDirectDraw7_AddRef(iface);
3258     object->ifaceToRelease = (IUnknown *) iface;
3259     *Palette = ICOM_INTERFACE(object, IDirectDrawPalette);
3260     LeaveCriticalSection(&ddraw_cs);
3261     return DD_OK;
3262 }
3263
3264 /*****************************************************************************
3265  * IDirectDraw7::DuplicateSurface
3266  *
3267  * Duplicates a surface. The surface memory points to the same memory as
3268  * the original surface, and it's released when the last surface referencing
3269  * it is released. I guess that's beyond Wine's surface management right now
3270  * (Idea: create a new DDraw surface with the same WineD3DSurface. I need a
3271  * test application to implement this)
3272  *
3273  * Params:
3274  *  Src: Address of the source surface
3275  *  Dest: Address to write the new surface pointer to
3276  *
3277  * Returns:
3278  *  See IDirectDraw7::CreateSurface
3279  *
3280  *****************************************************************************/
3281 static HRESULT WINAPI
3282 IDirectDrawImpl_DuplicateSurface(IDirectDraw7 *iface,
3283                                  IDirectDrawSurface7 *Src,
3284                                  IDirectDrawSurface7 **Dest)
3285 {
3286     ICOM_THIS_FROM(IDirectDrawImpl, IDirectDraw7, iface);
3287     IDirectDrawSurfaceImpl *Surf = ICOM_OBJECT(IDirectDrawSurfaceImpl, IDirectDrawSurface7, Src);
3288
3289     FIXME("(%p)->(%p,%p)\n", This, Surf, Dest);
3290
3291     /* For now, simply create a new, independent surface */
3292     return IDirectDraw7_CreateSurface(iface,
3293                                       &Surf->surface_desc,
3294                                       Dest,
3295                                       NULL);
3296 }
3297
3298 /*****************************************************************************
3299  * IDirectDraw7 VTable
3300  *****************************************************************************/
3301 const IDirectDraw7Vtbl IDirectDraw7_Vtbl =
3302 {
3303     /*** IUnknown ***/
3304     IDirectDrawImpl_QueryInterface,
3305     IDirectDrawImpl_AddRef,
3306     IDirectDrawImpl_Release,
3307     /*** IDirectDraw ***/
3308     IDirectDrawImpl_Compact,
3309     IDirectDrawImpl_CreateClipper,
3310     IDirectDrawImpl_CreatePalette,
3311     IDirectDrawImpl_CreateSurface,
3312     IDirectDrawImpl_DuplicateSurface,
3313     IDirectDrawImpl_EnumDisplayModes,
3314     IDirectDrawImpl_EnumSurfaces,
3315     IDirectDrawImpl_FlipToGDISurface,
3316     IDirectDrawImpl_GetCaps,
3317     IDirectDrawImpl_GetDisplayMode,
3318     IDirectDrawImpl_GetFourCCCodes,
3319     IDirectDrawImpl_GetGDISurface,
3320     IDirectDrawImpl_GetMonitorFrequency,
3321     IDirectDrawImpl_GetScanLine,
3322     IDirectDrawImpl_GetVerticalBlankStatus,
3323     IDirectDrawImpl_Initialize,
3324     IDirectDrawImpl_RestoreDisplayMode,
3325     IDirectDrawImpl_SetCooperativeLevel,
3326     IDirectDrawImpl_SetDisplayMode,
3327     IDirectDrawImpl_WaitForVerticalBlank,
3328     /*** IDirectDraw2 ***/
3329     IDirectDrawImpl_GetAvailableVidMem,
3330     /*** IDirectDraw7 ***/
3331     IDirectDrawImpl_GetSurfaceFromDC,
3332     IDirectDrawImpl_RestoreAllSurfaces,
3333     IDirectDrawImpl_TestCooperativeLevel,
3334     IDirectDrawImpl_GetDeviceIdentifier,
3335     /*** IDirectDraw7 ***/
3336     IDirectDrawImpl_StartModeTest,
3337     IDirectDrawImpl_EvaluateMode
3338 };
3339
3340 /*****************************************************************************
3341  * IDirectDrawImpl_FindDecl
3342  *
3343  * Finds the WineD3D vertex declaration for a specific fvf, and creates one
3344  * if none was found.
3345  *
3346  * This function is in ddraw.c and the DDraw object space because D3D7
3347  * vertex buffers are created using the IDirect3D interface to the ddraw
3348  * object, so they can be valid across D3D devices(theoretically. The ddraw
3349  * object also owns the wined3d device
3350  *
3351  * Parameters:
3352  *  This: Device
3353  *  fvf: Fvf to find the decl for
3354  *
3355  * Returns:
3356  *  NULL in case of an error, the IWineD3DVertexDeclaration interface for the
3357  *  fvf otherwise.
3358  *
3359  *****************************************************************************/
3360 IWineD3DVertexDeclaration *
3361 IDirectDrawImpl_FindDecl(IDirectDrawImpl *This,
3362                          DWORD fvf)
3363 {
3364     HRESULT hr;
3365     IWineD3DVertexDeclaration* pDecl = NULL;
3366     int p, low, high; /* deliberately signed */
3367     struct FvfToDecl *convertedDecls = This->decls;
3368
3369     TRACE("Searching for declaration for fvf %08x... ", fvf);
3370
3371     low = 0;
3372     high = This->numConvertedDecls - 1;
3373     while(low <= high) {
3374         p = (low + high) >> 1;
3375         TRACE("%d ", p);
3376         if(convertedDecls[p].fvf == fvf) {
3377             TRACE("found %p\n", convertedDecls[p].decl);
3378             return convertedDecls[p].decl;
3379         } else if(convertedDecls[p].fvf < fvf) {
3380             low = p + 1;
3381         } else {
3382             high = p - 1;
3383         }
3384     }
3385     TRACE("not found. Creating and inserting at position %d.\n", low);
3386
3387     hr = IWineD3DDevice_CreateVertexDeclarationFromFVF(This->wineD3DDevice,
3388                                                        &pDecl,
3389                                                        (IUnknown *) ICOM_INTERFACE(This, IDirectDraw7),
3390                                                        fvf);
3391     if (hr != S_OK) return NULL;
3392
3393     if(This->declArraySize == This->numConvertedDecls) {
3394         int grow = max(This->declArraySize / 2, 8);
3395         convertedDecls = HeapReAlloc(GetProcessHeap(), 0, convertedDecls,
3396                                      sizeof(convertedDecls[0]) * (This->numConvertedDecls + grow));
3397         if(!convertedDecls) {
3398             /* This will destroy it */
3399             IWineD3DVertexDeclaration_Release(pDecl);
3400             return NULL;
3401         }
3402         This->decls = convertedDecls;
3403         This->declArraySize += grow;
3404     }
3405
3406     memmove(convertedDecls + low + 1, convertedDecls + low, sizeof(convertedDecls[0]) * (This->numConvertedDecls - low));
3407     convertedDecls[low].decl = pDecl;
3408     convertedDecls[low].fvf = fvf;
3409     This->numConvertedDecls++;
3410
3411     TRACE("Returning %p. %d decls in array\n", pDecl, This->numConvertedDecls);
3412     return pDecl;
3413 }