1 /* DirectDraw Base Functions
3 * Copyright 1997-1999 Marcus Meissner
4 * Copyright 1998 Lionel Ulmer
5 * Copyright 2000-2001 TransGaming Technologies Inc.
6 * Copyright 2006 Stefan Dösinger
7 * Copyright 2008 Denver Gingerich
9 * This file contains the (internal) driver registration functions,
10 * driver enumeration APIs and DirectDraw creation functions.
12 * This library is free software; you can redistribute it and/or
13 * modify it under the terms of the GNU Lesser General Public
14 * License as published by the Free Software Foundation; either
15 * version 2.1 of the License, or (at your option) any later version.
17 * This library is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
20 * Lesser General Public License for more details.
22 * You should have received a copy of the GNU Lesser General Public
23 * License along with this library; if not, write to the Free Software
24 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
28 #include "wine/port.h"
29 #include "wine/debug.h"
42 #include "wine/exception.h"
48 #define DDRAW_INIT_GUID
49 #include "ddraw_private.h"
51 static typeof(WineDirect3DCreate) *pWineDirect3DCreate;
53 WINE_DEFAULT_DEBUG_CHANNEL(ddraw);
55 /* The configured default surface */
56 WINED3DSURFTYPE DefaultSurfaceType = SURFACE_UNKNOWN;
58 /* DDraw list and critical section */
59 static struct list global_ddraw_list = LIST_INIT(global_ddraw_list);
61 static CRITICAL_SECTION_DEBUG ddraw_cs_debug =
64 { &ddraw_cs_debug.ProcessLocksList,
65 &ddraw_cs_debug.ProcessLocksList },
66 0, 0, { (DWORD_PTR)(__FILE__ ": ddraw_cs") }
68 CRITICAL_SECTION ddraw_cs = { &ddraw_cs_debug, -1, 0, 0, 0, 0 };
70 /* value of ForceRefreshRate */
71 DWORD force_refresh_rate = 0;
74 * Helper Function for DDRAW_Create and DirectDrawCreateClipper for
75 * lazy loading of the Wine D3D driver.
82 BOOL LoadWineD3D(void)
84 static HMODULE hWineD3D = (HMODULE) -1;
85 if (hWineD3D == (HMODULE) -1)
87 hWineD3D = LoadLibraryA("wined3d");
90 pWineDirect3DCreate = (typeof(WineDirect3DCreate) *)GetProcAddress(hWineD3D, "WineDirect3DCreate");
91 pWineDirect3DCreateClipper = (typeof(WineDirect3DCreateClipper) *) GetProcAddress(hWineD3D, "WineDirect3DCreateClipper");
95 return hWineD3D != NULL;
98 /***********************************************************************
100 * Helper function for DirectDrawCreate and friends
101 * Creates a new DDraw interface with the given REFIID
103 * Interfaces that can be created:
104 * IDirectDraw, IDirectDraw2, IDirectDraw4, IDirectDraw7
105 * IDirect3D, IDirect3D2, IDirect3D3, IDirect3D7. (Does Windows return
106 * IDirect3D interfaces?)
109 * guid: ID of the requested driver, NULL for the default driver.
110 * The GUID can be queried with DirectDrawEnumerate(Ex)A/W
111 * DD: Used to return the pointer to the created object
112 * UnkOuter: For aggregation, which is unsupported. Must be NULL
113 * iid: requested version ID.
116 * DD_OK if the Interface was created successfully
117 * CLASS_E_NOAGGREGATION if UnkOuter is not NULL
118 * E_OUTOFMEMORY if some allocation failed
120 ***********************************************************************/
122 DDRAW_Create(const GUID *guid,
127 IDirectDrawImpl *This = NULL;
129 IWineD3D *wineD3D = NULL;
130 IWineD3DDevice *wineD3DDevice = NULL;
132 WINED3DDEVTYPE devicetype;
134 TRACE("(%s,%p,%p)\n", debugstr_guid(guid), DD, UnkOuter);
138 /* We don't care about this guids. Well, there's no special guid anyway
141 if (guid == (GUID *) DDCREATE_EMULATIONONLY)
143 /* Use the reference device id. This doesn't actually change anything,
144 * WineD3D always uses OpenGL for D3D rendering. One could make it request
147 devicetype = WINED3DDEVTYPE_REF;
149 else if(guid == (GUID *) DDCREATE_HARDWAREONLY)
151 devicetype = WINED3DDEVTYPE_HAL;
158 /* DDraw doesn't support aggregation, according to msdn */
159 if (UnkOuter != NULL)
160 return CLASS_E_NOAGGREGATION;
162 /* DirectDraw creation comes here */
163 This = HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, sizeof(IDirectDrawImpl));
166 ERR("Out of memory when creating DirectDraw\n");
167 return E_OUTOFMEMORY;
171 * IDirectDraw and IDirect3D are the same object,
172 * QueryInterface is used to get other interfaces.
174 This->lpVtbl = &IDirectDraw7_Vtbl;
175 This->IDirectDraw_vtbl = &IDirectDraw1_Vtbl;
176 This->IDirectDraw2_vtbl = &IDirectDraw2_Vtbl;
177 This->IDirectDraw3_vtbl = &IDirectDraw3_Vtbl;
178 This->IDirectDraw4_vtbl = &IDirectDraw4_Vtbl;
179 This->IDirect3D_vtbl = &IDirect3D1_Vtbl;
180 This->IDirect3D2_vtbl = &IDirect3D2_Vtbl;
181 This->IDirect3D3_vtbl = &IDirect3D3_Vtbl;
182 This->IDirect3D7_vtbl = &IDirect3D7_Vtbl;
183 This->device_parent_vtbl = &ddraw_wined3d_device_parent_vtbl;
185 /* See comments in IDirectDrawImpl_CreateNewSurface for a description
187 * Read from a registry key, should add a winecfg option later
189 This->ImplType = DefaultSurfaceType;
191 /* Get the current screen settings */
193 This->orig_bpp = GetDeviceCaps(hDC, BITSPIXEL) * GetDeviceCaps(hDC, PLANES);
195 This->orig_width = GetSystemMetrics(SM_CXSCREEN);
196 This->orig_height = GetSystemMetrics(SM_CYSCREEN);
200 ERR("Couldn't load WineD3D - OpenGL libs not present?\n");
201 hr = DDERR_NODIRECTDRAWSUPPORT;
205 /* Initialize WineD3D
207 * All Rendering (2D and 3D) is relayed to WineD3D,
208 * but DirectDraw specific management, like DDSURFACEDESC and DDPIXELFORMAT
209 * structure handling is handled in this lib.
211 wineD3D = pWineDirect3DCreate(7 /* DXVersion */, (IUnknown *) This /* Parent */);
214 ERR("Failed to initialise WineD3D\n");
218 This->wineD3D = wineD3D;
219 TRACE("WineD3D created at %p\n", wineD3D);
221 /* Initialized member...
223 * It is set to false at creation time, and set to true in
224 * IDirectDraw7::Initialize. Its sole purpose is to return DD_OK on
225 * initialize only once
227 This->initialized = FALSE;
229 /* Initialize WineD3DDevice
231 * It is used for screen setup, surface and palette creation
232 * When a Direct3DDevice7 is created, the D3D capabilities of WineD3D are
235 hr = IWineD3D_CreateDevice(wineD3D, 0 /* D3D_ADAPTER_DEFAULT */, devicetype, NULL /* FocusWindow, don't know yet */,
236 0 /* BehaviorFlags */, (IUnknown *)This, (IWineD3DDeviceParent *)&This->device_parent_vtbl, &wineD3DDevice);
239 ERR("Failed to create a wineD3DDevice, result = %x\n", hr);
242 This->wineD3DDevice = wineD3DDevice;
243 TRACE("wineD3DDevice created at %p\n", This->wineD3DDevice);
245 /* Register the window class
247 * It is used to create a hidden window for D3D
248 * rendering, if the application didn't pass one.
249 * It can also be used for Creating a device window
250 * from SetCooperativeLevel
252 * The name: DDRAW_<address>. The classname is
253 * 32 bit long, so a 64 bit address will fit nicely
254 * (Will this be compiled for 64 bit anyway?)
257 sprintf(This->classname, "DDRAW_%p", This);
259 memset(&This->wnd_class, 0, sizeof(This->wnd_class));
260 This->wnd_class.style = CS_HREDRAW | CS_VREDRAW;
261 This->wnd_class.lpfnWndProc = DefWindowProcA;
262 This->wnd_class.cbClsExtra = 0;
263 This->wnd_class.cbWndExtra = 0;
264 This->wnd_class.hInstance = GetModuleHandleA(0);
265 This->wnd_class.hIcon = 0;
266 This->wnd_class.hCursor = 0;
267 This->wnd_class.hbrBackground = GetStockObject(BLACK_BRUSH);
268 This->wnd_class.lpszMenuName = NULL;
269 This->wnd_class.lpszClassName = This->classname;
270 if(!RegisterClassA(&This->wnd_class))
272 ERR("RegisterClassA failed!\n");
276 /* Get the amount of video memory */
277 This->total_vidmem = IWineD3DDevice_GetAvailableTextureMem(This->wineD3DDevice);
279 list_init(&This->surface_list);
280 list_add_head(&global_ddraw_list, &This->ddraw_list_entry);
282 /* Call QueryInterface to get the pointer to the requested interface. This also initializes
283 * The required refcount
285 hr = IDirectDraw7_QueryInterface((IDirectDraw7 *)This, iid, DD);
286 if(SUCCEEDED(hr)) return DD_OK;
289 /* Let's hope we never need this ;) */
290 if(wineD3DDevice) IWineD3DDevice_Release(wineD3DDevice);
291 if(wineD3D) IWineD3D_Release(wineD3D);
292 if(This) HeapFree(GetProcessHeap(), 0, This->decls);
293 HeapFree(GetProcessHeap(), 0, This);
297 /***********************************************************************
298 * DirectDrawCreate (DDRAW.@)
300 * Creates legacy DirectDraw Interfaces. Can't create IDirectDraw7
301 * interfaces in theory
303 * Arguments, return values: See DDRAW_Create
305 ***********************************************************************/
307 DirectDrawCreate(GUID *GUID,
312 TRACE("(%s,%p,%p)\n", debugstr_guid(GUID), DD, UnkOuter);
314 EnterCriticalSection(&ddraw_cs);
315 hr = DDRAW_Create(GUID, (void **) DD, UnkOuter, &IID_IDirectDraw);
316 LeaveCriticalSection(&ddraw_cs);
320 /***********************************************************************
321 * DirectDrawCreateEx (DDRAW.@)
323 * Only creates new IDirectDraw7 interfaces, supposed to fail if legacy
324 * interfaces are requested.
326 * Arguments, return values: See DDRAW_Create
328 ***********************************************************************/
330 DirectDrawCreateEx(GUID *GUID,
336 TRACE("(%s,%p,%s,%p)\n", debugstr_guid(GUID), DD, debugstr_guid(iid), UnkOuter);
338 if (!IsEqualGUID(iid, &IID_IDirectDraw7))
339 return DDERR_INVALIDPARAMS;
341 EnterCriticalSection(&ddraw_cs);
342 hr = DDRAW_Create(GUID, DD, UnkOuter, iid);
343 LeaveCriticalSection(&ddraw_cs);
347 /***********************************************************************
348 * DirectDrawEnumerateA (DDRAW.@)
350 * Enumerates legacy ddraw drivers, ascii version. We only have one
351 * driver, which relays to WineD3D. If we were sufficiently cool,
352 * we could offer various interfaces, which use a different default surface
353 * implementation, but I think it's better to offer this choice in
354 * winecfg, because some apps use the default driver, so we would need
355 * a winecfg option anyway, and there shouldn't be 2 ways to set one setting
358 * Callback: Callback function from the app
359 * Context: Argument to the call back.
363 * E_INVALIDARG if the Callback caused a page fault
366 ***********************************************************************/
368 DirectDrawEnumerateA(LPDDENUMCALLBACKA Callback,
373 TRACE(" Enumerating default DirectDraw HAL interface\n");
374 /* We only have one driver */
377 static CHAR driver_desc[] = "DirectDraw HAL",
378 driver_name[] = "display";
380 stop = !Callback(NULL, driver_desc, driver_name, Context);
388 TRACE(" End of enumeration\n");
392 /***********************************************************************
393 * DirectDrawEnumerateExA (DDRAW.@)
395 * Enumerates DirectDraw7 drivers, ascii version. See
396 * the comments above DirectDrawEnumerateA for more details.
398 * The Flag member is not supported right now.
400 ***********************************************************************/
402 DirectDrawEnumerateExA(LPDDENUMCALLBACKEXA Callback,
407 TRACE("Enumerating default DirectDraw HAL interface\n");
409 /* We only have one driver by now */
412 static CHAR driver_desc[] = "DirectDraw HAL",
413 driver_name[] = "display";
415 /* QuickTime expects the description "DirectDraw HAL" */
416 stop = !Callback(NULL, driver_desc, driver_name, Context, 0);
424 TRACE("End of enumeration\n");
428 /***********************************************************************
429 * DirectDrawEnumerateW (DDRAW.@)
431 * Enumerates legacy drivers, unicode version. See
432 * the comments above DirectDrawEnumerateA for more details.
434 * The Flag member is not supported right now.
436 ***********************************************************************/
438 /***********************************************************************
439 * DirectDrawEnumerateExW (DDRAW.@)
441 * Enumerates DirectDraw7 drivers, unicode version. See
442 * the comments above DirectDrawEnumerateA for more details.
444 * The Flag member is not supported right now.
446 ***********************************************************************/
448 /***********************************************************************
449 * Classfactory implementation.
450 ***********************************************************************/
452 /***********************************************************************
453 * CF_CreateDirectDraw
455 * DDraw creation function for the class factory
458 * UnkOuter: Set to NULL
459 * iid: ID of the wanted interface
460 * obj: Address to pass the interface pointer back
463 * DD_OK / DDERR*, see DDRAW_Create
465 ***********************************************************************/
467 CF_CreateDirectDraw(IUnknown* UnkOuter, REFIID iid,
472 TRACE("(%p,%s,%p)\n", UnkOuter, debugstr_guid(iid), obj);
474 EnterCriticalSection(&ddraw_cs);
475 hr = DDRAW_Create(NULL, obj, UnkOuter, iid);
476 LeaveCriticalSection(&ddraw_cs);
480 /***********************************************************************
481 * CF_CreateDirectDraw
483 * Clipper creation function for the class factory
486 * UnkOuter: Set to NULL
487 * iid: ID of the wanted interface
488 * obj: Address to pass the interface pointer back
491 * DD_OK / DDERR*, see DDRAW_Create
493 ***********************************************************************/
495 CF_CreateDirectDrawClipper(IUnknown* UnkOuter, REFIID riid,
499 IDirectDrawClipper *Clip;
501 EnterCriticalSection(&ddraw_cs);
502 hr = DirectDrawCreateClipper(0, &Clip, UnkOuter);
505 LeaveCriticalSection(&ddraw_cs);
509 hr = IDirectDrawClipper_QueryInterface(Clip, riid, obj);
510 IDirectDrawClipper_Release(Clip);
512 LeaveCriticalSection(&ddraw_cs);
516 static const struct object_creation_info object_creation[] =
518 { &CLSID_DirectDraw, CF_CreateDirectDraw },
519 { &CLSID_DirectDraw7, CF_CreateDirectDraw },
520 { &CLSID_DirectDrawClipper, CF_CreateDirectDrawClipper }
523 /*******************************************************************************
524 * IDirectDrawClassFactory::QueryInterface
526 * QueryInterface for the class factory
529 * riid Reference to identifier of queried interface
530 * ppv Address to return the interface pointer at
534 * Failure: E_NOINTERFACE
536 *******************************************************************************/
537 static HRESULT WINAPI
538 IDirectDrawClassFactoryImpl_QueryInterface(IClassFactory *iface,
542 IClassFactoryImpl *This = (IClassFactoryImpl *)iface;
544 TRACE("(%p)->(%s,%p)\n", This, debugstr_guid(riid), obj);
546 if (IsEqualGUID(riid, &IID_IUnknown)
547 || IsEqualGUID(riid, &IID_IClassFactory))
549 IClassFactory_AddRef(iface);
554 WARN("(%p)->(%s,%p),not found\n",This,debugstr_guid(riid),obj);
555 return E_NOINTERFACE;
558 /*******************************************************************************
559 * IDirectDrawClassFactory::AddRef
561 * AddRef for the class factory
566 *******************************************************************************/
568 IDirectDrawClassFactoryImpl_AddRef(IClassFactory *iface)
570 IClassFactoryImpl *This = (IClassFactoryImpl *)iface;
571 ULONG ref = InterlockedIncrement(&This->ref);
573 TRACE("(%p)->() incrementing from %d.\n", This, ref - 1);
578 /*******************************************************************************
579 * IDirectDrawClassFactory::Release
581 * Release for the class factory. If the refcount falls to 0, the object
587 *******************************************************************************/
589 IDirectDrawClassFactoryImpl_Release(IClassFactory *iface)
591 IClassFactoryImpl *This = (IClassFactoryImpl *)iface;
592 ULONG ref = InterlockedDecrement(&This->ref);
593 TRACE("(%p)->() decrementing from %d.\n", This, ref+1);
596 HeapFree(GetProcessHeap(), 0, This);
602 /*******************************************************************************
603 * IDirectDrawClassFactory::CreateInstance
605 * What is this? Seems to create DirectDraw objects...
608 * The usual things???
613 *******************************************************************************/
614 static HRESULT WINAPI
615 IDirectDrawClassFactoryImpl_CreateInstance(IClassFactory *iface,
620 IClassFactoryImpl *This = (IClassFactoryImpl *)iface;
622 TRACE("(%p)->(%p,%s,%p)\n",This,UnkOuter,debugstr_guid(riid),obj);
624 return This->pfnCreateInstance(UnkOuter, riid, obj);
627 /*******************************************************************************
628 * IDirectDrawClassFactory::LockServer
636 * S_OK, because it's a stub
638 *******************************************************************************/
639 static HRESULT WINAPI
640 IDirectDrawClassFactoryImpl_LockServer(IClassFactory *iface,BOOL dolock)
642 IClassFactoryImpl *This = (IClassFactoryImpl *)iface;
643 FIXME("(%p)->(%d),stub!\n",This,dolock);
647 /*******************************************************************************
648 * The class factory VTable
649 *******************************************************************************/
650 static const IClassFactoryVtbl IClassFactory_Vtbl =
652 IDirectDrawClassFactoryImpl_QueryInterface,
653 IDirectDrawClassFactoryImpl_AddRef,
654 IDirectDrawClassFactoryImpl_Release,
655 IDirectDrawClassFactoryImpl_CreateInstance,
656 IDirectDrawClassFactoryImpl_LockServer
659 /*******************************************************************************
660 * DllGetClassObject [DDRAW.@]
661 * Retrieves class object from a DLL object
664 * Docs say returns STDAPI
667 * rclsid [I] CLSID for the class object
668 * riid [I] Reference to identifier of interface for class object
669 * ppv [O] Address of variable to receive interface pointer for riid
673 * Failure: CLASS_E_CLASSNOTAVAILABLE, E_OUTOFMEMORY, E_INVALIDARG,
676 HRESULT WINAPI DllGetClassObject(REFCLSID rclsid, REFIID riid, LPVOID *ppv)
679 IClassFactoryImpl *factory;
681 TRACE("(%s,%s,%p)\n", debugstr_guid(rclsid), debugstr_guid(riid), ppv);
683 if ( !IsEqualGUID( &IID_IClassFactory, riid )
684 && ! IsEqualGUID( &IID_IUnknown, riid) )
685 return E_NOINTERFACE;
687 for (i=0; i < sizeof(object_creation)/sizeof(object_creation[0]); i++)
689 if (IsEqualGUID(object_creation[i].clsid, rclsid))
693 if (i == sizeof(object_creation)/sizeof(object_creation[0]))
695 FIXME("%s: no class found.\n", debugstr_guid(rclsid));
696 return CLASS_E_CLASSNOTAVAILABLE;
699 factory = HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, sizeof(*factory));
700 if (factory == NULL) return E_OUTOFMEMORY;
702 factory->lpVtbl = &IClassFactory_Vtbl;
705 factory->pfnCreateInstance = object_creation[i].pfnCreateInstance;
712 /*******************************************************************************
713 * DllCanUnloadNow [DDRAW.@] Determines whether the DLL is in use.
719 HRESULT WINAPI DllCanUnloadNow(void)
722 FIXME("(void): stub\n");
724 EnterCriticalSection(&ddraw_cs);
726 LeaveCriticalSection(&ddraw_cs);
731 /*******************************************************************************
734 * Callback function for the EnumSurfaces call in DllMain.
735 * Dumps some surface info and releases the surface
738 * surf: The enumerated surface
739 * desc: it's description
740 * context: Pointer to the ddraw impl
744 *******************************************************************************/
745 static HRESULT WINAPI
746 DestroyCallback(IDirectDrawSurface7 *surf,
747 DDSURFACEDESC2 *desc,
750 IDirectDrawSurfaceImpl *Impl = (IDirectDrawSurfaceImpl *)surf;
751 IDirectDrawImpl *ddraw = context;
754 ref = IDirectDrawSurface7_Release(surf); /* For the EnumSurfaces */
755 WARN("Surface %p has an reference count of %d\n", Impl, ref);
757 /* Skip surfaces which are attached somewhere or which are
758 * part of a complex compound. They will get released when destroying
761 if( (!Impl->is_complex_root) || (Impl->first_attached != Impl) )
763 /* Skip our depth stencil surface, it will be released with the render target */
764 if( Impl == ddraw->DepthStencilBuffer)
767 /* Destroy the surface */
768 while(ref) ref = IDirectDrawSurface7_Release(surf);
773 /***********************************************************************
776 * Reads a config key from the registry. Taken from WineD3D
778 ***********************************************************************/
779 static inline DWORD get_config_key(HKEY defkey, HKEY appkey, const char* name, char* buffer, DWORD size)
781 if (0 != appkey && !RegQueryValueExA( appkey, name, 0, NULL, (LPBYTE) buffer, &size )) return 0;
782 if (0 != defkey && !RegQueryValueExA( defkey, name, 0, NULL, (LPBYTE) buffer, &size )) return 0;
783 return ERROR_FILE_NOT_FOUND;
786 /***********************************************************************
789 * Could be used to register DirectDraw drivers, if we have more than
790 * one. Also used to destroy any objects left at unload if the
791 * app didn't release them properly(Gothic 2, Diablo 2, Moto racer, ...)
793 ***********************************************************************/
795 DllMain(HINSTANCE hInstDLL,
799 TRACE("(%p,%x,%p)\n", hInstDLL, Reason, lpv);
800 if (Reason == DLL_PROCESS_ATTACH)
802 char buffer[MAX_PATH+10];
803 DWORD size = sizeof(buffer);
808 /* @@ Wine registry key: HKCU\Software\Wine\Direct3D */
809 if ( RegOpenKeyA( HKEY_CURRENT_USER, "Software\\Wine\\Direct3D", &hkey ) ) hkey = 0;
811 len = GetModuleFileNameA( 0, buffer, MAX_PATH );
812 if (len && len < MAX_PATH)
815 /* @@ Wine registry key: HKCU\Software\Wine\AppDefaults\app.exe\Direct3D */
816 if (!RegOpenKeyA( HKEY_CURRENT_USER, "Software\\Wine\\AppDefaults", &tmpkey ))
818 char *p, *appname = buffer;
819 if ((p = strrchr( appname, '/' ))) appname = p + 1;
820 if ((p = strrchr( appname, '\\' ))) appname = p + 1;
821 strcat( appname, "\\Direct3D" );
822 TRACE("appname = [%s]\n", appname);
823 if (RegOpenKeyA( tmpkey, appname, &appkey )) appkey = 0;
824 RegCloseKey( tmpkey );
828 if ( 0 != hkey || 0 != appkey )
830 if ( !get_config_key( hkey, appkey, "DirectDrawRenderer", buffer, size) )
832 if (!strcmp(buffer,"gdi"))
834 TRACE("Defaulting to GDI surfaces\n");
835 DefaultSurfaceType = SURFACE_GDI;
837 else if (!strcmp(buffer,"opengl"))
839 TRACE("Defaulting to opengl surfaces\n");
840 DefaultSurfaceType = SURFACE_OPENGL;
844 ERR("Unknown default surface type. Supported are:\n gdi, opengl\n");
849 /* On Windows one can force the refresh rate that DirectDraw uses by
850 * setting an override value in dxdiag. This is documented in KB315614
851 * (main article), KB230002, and KB217348. By comparing registry dumps
852 * before and after setting the override, we see that the override value
853 * is stored in HKLM\Software\Microsoft\DirectDraw\ForceRefreshRate as a
854 * DWORD that represents the refresh rate to force. We use this
855 * registry entry to modify the behavior of SetDisplayMode so that Wine
856 * users can override the refresh rate in a Windows-compatible way.
858 * dxdiag will not accept a refresh rate lower than 40 or higher than
859 * 120 so this value should be within that range. It is, of course,
860 * possible for a user to set the registry entry value directly so that
861 * assumption might not hold.
863 * There is no current mechanism for setting this value through the Wine
864 * GUI. It would be most appropriate to set this value through a dxdiag
865 * clone, but it may be sufficient to use winecfg.
867 * TODO: Create a mechanism for setting this value through the Wine GUI.
869 if ( !RegOpenKeyA( HKEY_LOCAL_MACHINE, "Software\\Microsoft\\DirectDraw", &hkey ) )
873 if (!RegQueryValueExA( hkey, "ForceRefreshRate", NULL, &type, (LPBYTE)&data, &size ) && type == REG_DWORD)
875 TRACE("ForceRefreshRate set; overriding refresh rate to %d Hz\n", data);
876 force_refresh_rate = data;
881 DisableThreadLibraryCalls(hInstDLL);
883 else if (Reason == DLL_PROCESS_DETACH)
885 if(!list_empty(&global_ddraw_list))
887 struct list *entry, *entry2;
888 WARN("There are still existing DirectDraw interfaces. Wine bug or buggy application?\n");
890 /* We remove elements from this loop */
891 LIST_FOR_EACH_SAFE(entry, entry2, &global_ddraw_list)
896 IDirectDrawImpl *ddraw = LIST_ENTRY(entry, IDirectDrawImpl, ddraw_list_entry);
898 WARN("DDraw %p has a refcount of %d\n", ddraw, ddraw->ref7 + ddraw->ref4 + ddraw->ref3 + ddraw->ref2 + ddraw->ref1);
900 /* Add references to each interface to avoid freeing them unexpectedly */
901 IDirectDraw_AddRef((IDirectDraw *)&ddraw->IDirectDraw_vtbl);
902 IDirectDraw2_AddRef((IDirectDraw2 *)&ddraw->IDirectDraw2_vtbl);
903 IDirectDraw3_AddRef((IDirectDraw3 *)&ddraw->IDirectDraw3_vtbl);
904 IDirectDraw4_AddRef((IDirectDraw4 *)&ddraw->IDirectDraw4_vtbl);
905 IDirectDraw7_AddRef((IDirectDraw7 *)ddraw);
907 /* Does a D3D device exist? Destroy it
908 * TODO: Destroy all Vertex buffers, Lights, Materials
909 * and execute buffers too
913 WARN("DDraw %p has d3ddevice %p attached\n", ddraw, ddraw->d3ddevice);
914 while(IDirect3DDevice7_Release((IDirect3DDevice7 *)ddraw->d3ddevice));
917 /* Try to release the objects
918 * Do an EnumSurfaces to find any hanging surfaces
920 memset(&desc, 0, sizeof(desc));
921 desc.dwSize = sizeof(desc);
922 for(i = 0; i <= 1; i++)
924 hr = IDirectDraw7_EnumSurfaces((IDirectDraw7 *)ddraw,
925 DDENUMSURFACES_ALL, &desc, ddraw, DestroyCallback);
927 ERR("(%p) EnumSurfaces failed, prepare for trouble\n", ddraw);
930 /* Check the surface count */
931 if(ddraw->surfaces > 0)
932 ERR("DDraw %p still has %d surfaces attached\n", ddraw, ddraw->surfaces);
934 /* Release all hanging references to destroy the objects. This
935 * restores the screen mode too
937 while(IDirectDraw_Release((IDirectDraw *)&ddraw->IDirectDraw_vtbl));
938 while(IDirectDraw2_Release((IDirectDraw2 *)&ddraw->IDirectDraw2_vtbl));
939 while(IDirectDraw3_Release((IDirectDraw3 *)&ddraw->IDirectDraw3_vtbl));
940 while(IDirectDraw4_Release((IDirectDraw4 *)&ddraw->IDirectDraw4_vtbl));
941 while(IDirectDraw7_Release((IDirectDraw7 *)ddraw));