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"
30 #define DDRAW_INIT_GUID
31 #include "ddraw_private.h"
33 #include "wine/exception.h"
36 static typeof(WineDirect3DCreate) *pWineDirect3DCreate;
38 WINE_DEFAULT_DEBUG_CHANNEL(ddraw);
40 /* The configured default surface */
41 WINED3DSURFTYPE DefaultSurfaceType = SURFACE_UNKNOWN;
43 /* DDraw list and critical section */
44 static struct list global_ddraw_list = LIST_INIT(global_ddraw_list);
46 static CRITICAL_SECTION_DEBUG ddraw_cs_debug =
49 { &ddraw_cs_debug.ProcessLocksList,
50 &ddraw_cs_debug.ProcessLocksList },
51 0, 0, { (DWORD_PTR)(__FILE__ ": ddraw_cs") }
53 CRITICAL_SECTION ddraw_cs = { &ddraw_cs_debug, -1, 0, 0, 0, 0 };
55 /* value of ForceRefreshRate */
56 DWORD force_refresh_rate = 0;
58 /* Handle table functions */
59 BOOL ddraw_handle_table_init(struct ddraw_handle_table *t, UINT initial_size)
61 t->entries = HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, initial_size * sizeof(*t->entries));
64 ERR("Failed to allocate handle table memory.\n");
67 t->free_entries = NULL;
68 t->table_size = initial_size;
74 void ddraw_handle_table_destroy(struct ddraw_handle_table *t)
76 HeapFree(GetProcessHeap(), 0, t->entries);
77 memset(t, 0, sizeof(*t));
80 DWORD ddraw_allocate_handle(struct ddraw_handle_table *t, void *object, enum ddraw_handle_type type)
82 struct ddraw_handle_entry *entry;
86 DWORD idx = t->free_entries - t->entries;
87 /* Use a free handle */
88 entry = t->free_entries;
89 if (entry->type != DDRAW_HANDLE_FREE)
91 ERR("Handle %#x (%p) is in the free list, but has type %#x.\n", idx, entry->object, entry->type);
92 return DDRAW_INVALID_HANDLE;
94 t->free_entries = entry->object;
95 entry->object = object;
101 if (!(t->entry_count < t->table_size))
104 UINT new_size = t->table_size + (t->table_size >> 1);
105 struct ddraw_handle_entry *new_entries = HeapReAlloc(GetProcessHeap(),
106 0, t->entries, new_size * sizeof(*t->entries));
109 ERR("Failed to grow the handle table.\n");
110 return DDRAW_INVALID_HANDLE;
112 t->entries = new_entries;
113 t->table_size = new_size;
116 entry = &t->entries[t->entry_count];
117 entry->object = object;
120 return t->entry_count++;
123 void *ddraw_free_handle(struct ddraw_handle_table *t, DWORD handle, enum ddraw_handle_type type)
125 struct ddraw_handle_entry *entry;
128 if (handle == DDRAW_INVALID_HANDLE || handle >= t->entry_count)
130 WARN("Invalid handle %#x passed.\n", handle);
134 entry = &t->entries[handle];
135 if (entry->type != type)
137 WARN("Handle %#x (%p) is not of type %#x.\n", handle, entry->object, type);
141 object = entry->object;
142 entry->object = t->free_entries;
143 entry->type = DDRAW_HANDLE_FREE;
144 t->free_entries = entry;
149 void *ddraw_get_object(struct ddraw_handle_table *t, DWORD handle, enum ddraw_handle_type type)
151 struct ddraw_handle_entry *entry;
153 if (handle == DDRAW_INVALID_HANDLE || handle >= t->entry_count)
155 WARN("Invalid handle %#x passed.\n", handle);
159 entry = &t->entries[handle];
160 if (entry->type != type)
162 WARN("Handle %#x (%p) is not of type %#x.\n", handle, entry->object, type);
166 return entry->object;
170 * Helper Function for DDRAW_Create and DirectDrawCreateClipper for
171 * lazy loading of the Wine D3D driver.
178 BOOL LoadWineD3D(void)
180 static HMODULE hWineD3D = (HMODULE) -1;
181 if (hWineD3D == (HMODULE) -1)
183 hWineD3D = LoadLibraryA("wined3d");
186 pWineDirect3DCreate = (typeof(WineDirect3DCreate) *)GetProcAddress(hWineD3D, "WineDirect3DCreate");
187 pWineDirect3DCreateClipper = (typeof(WineDirect3DCreateClipper) *) GetProcAddress(hWineD3D, "WineDirect3DCreateClipper");
191 return hWineD3D != NULL;
194 /***********************************************************************
196 * Helper function for DirectDrawCreate and friends
197 * Creates a new DDraw interface with the given REFIID
199 * Interfaces that can be created:
200 * IDirectDraw, IDirectDraw2, IDirectDraw4, IDirectDraw7
201 * IDirect3D, IDirect3D2, IDirect3D3, IDirect3D7. (Does Windows return
202 * IDirect3D interfaces?)
205 * guid: ID of the requested driver, NULL for the default driver.
206 * The GUID can be queried with DirectDrawEnumerate(Ex)A/W
207 * DD: Used to return the pointer to the created object
208 * UnkOuter: For aggregation, which is unsupported. Must be NULL
209 * iid: requested version ID.
212 * DD_OK if the Interface was created successfully
213 * CLASS_E_NOAGGREGATION if UnkOuter is not NULL
214 * E_OUTOFMEMORY if some allocation failed
216 ***********************************************************************/
218 DDRAW_Create(const GUID *guid,
223 IDirectDrawImpl *This = NULL;
225 IWineD3D *wineD3D = NULL;
226 IWineD3DDevice *wineD3DDevice = NULL;
228 WINED3DDEVTYPE devicetype;
230 TRACE("(%s,%p,%p)\n", debugstr_guid(guid), DD, UnkOuter);
234 /* We don't care about this guids. Well, there's no special guid anyway
237 if (guid == (GUID *) DDCREATE_EMULATIONONLY)
239 /* Use the reference device id. This doesn't actually change anything,
240 * WineD3D always uses OpenGL for D3D rendering. One could make it request
243 devicetype = WINED3DDEVTYPE_REF;
245 else if(guid == (GUID *) DDCREATE_HARDWAREONLY)
247 devicetype = WINED3DDEVTYPE_HAL;
254 /* DDraw doesn't support aggregation, according to msdn */
255 if (UnkOuter != NULL)
256 return CLASS_E_NOAGGREGATION;
258 /* DirectDraw creation comes here */
259 This = HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, sizeof(IDirectDrawImpl));
262 ERR("Out of memory when creating DirectDraw\n");
263 return E_OUTOFMEMORY;
267 * IDirectDraw and IDirect3D are the same object,
268 * QueryInterface is used to get other interfaces.
270 This->lpVtbl = &IDirectDraw7_Vtbl;
271 This->IDirectDraw_vtbl = &IDirectDraw1_Vtbl;
272 This->IDirectDraw2_vtbl = &IDirectDraw2_Vtbl;
273 This->IDirectDraw3_vtbl = &IDirectDraw3_Vtbl;
274 This->IDirectDraw4_vtbl = &IDirectDraw4_Vtbl;
275 This->IDirect3D_vtbl = &IDirect3D1_Vtbl;
276 This->IDirect3D2_vtbl = &IDirect3D2_Vtbl;
277 This->IDirect3D3_vtbl = &IDirect3D3_Vtbl;
278 This->IDirect3D7_vtbl = &IDirect3D7_Vtbl;
279 This->device_parent_vtbl = &ddraw_wined3d_device_parent_vtbl;
281 /* See comments in IDirectDrawImpl_CreateNewSurface for a description
283 * Read from a registry key, should add a winecfg option later
285 This->ImplType = DefaultSurfaceType;
287 /* Get the current screen settings */
289 This->orig_bpp = GetDeviceCaps(hDC, BITSPIXEL) * GetDeviceCaps(hDC, PLANES);
291 This->orig_width = GetSystemMetrics(SM_CXSCREEN);
292 This->orig_height = GetSystemMetrics(SM_CYSCREEN);
296 ERR("Couldn't load WineD3D - OpenGL libs not present?\n");
297 hr = DDERR_NODIRECTDRAWSUPPORT;
301 /* Initialize WineD3D
303 * All Rendering (2D and 3D) is relayed to WineD3D,
304 * but DirectDraw specific management, like DDSURFACEDESC and DDPIXELFORMAT
305 * structure handling is handled in this lib.
307 wineD3D = pWineDirect3DCreate(7 /* DXVersion */, (IUnknown *) This /* Parent */);
310 ERR("Failed to initialise WineD3D\n");
314 This->wineD3D = wineD3D;
315 TRACE("WineD3D created at %p\n", wineD3D);
317 /* Initialized member...
319 * It is set to false at creation time, and set to true in
320 * IDirectDraw7::Initialize. Its sole purpose is to return DD_OK on
321 * initialize only once
323 This->initialized = FALSE;
325 /* Initialize WineD3DDevice
327 * It is used for screen setup, surface and palette creation
328 * When a Direct3DDevice7 is created, the D3D capabilities of WineD3D are
331 hr = IWineD3D_CreateDevice(wineD3D, 0 /* D3D_ADAPTER_DEFAULT */, devicetype, NULL /* FocusWindow, don't know yet */,
332 0 /* BehaviorFlags */, (IUnknown *)This, (IWineD3DDeviceParent *)&This->device_parent_vtbl, &wineD3DDevice);
335 ERR("Failed to create a wineD3DDevice, result = %x\n", hr);
338 This->wineD3DDevice = wineD3DDevice;
339 TRACE("wineD3DDevice created at %p\n", This->wineD3DDevice);
341 /* Get the amount of video memory */
342 This->total_vidmem = IWineD3DDevice_GetAvailableTextureMem(This->wineD3DDevice);
344 list_init(&This->surface_list);
345 list_add_head(&global_ddraw_list, &This->ddraw_list_entry);
347 /* Call QueryInterface to get the pointer to the requested interface. This also initializes
348 * The required refcount
350 hr = IDirectDraw7_QueryInterface((IDirectDraw7 *)This, iid, DD);
351 if(SUCCEEDED(hr)) return DD_OK;
354 /* Let's hope we never need this ;) */
355 if(wineD3DDevice) IWineD3DDevice_Release(wineD3DDevice);
356 if(wineD3D) IWineD3D_Release(wineD3D);
357 HeapFree(GetProcessHeap(), 0, This->decls);
358 HeapFree(GetProcessHeap(), 0, This);
362 /***********************************************************************
363 * DirectDrawCreate (DDRAW.@)
365 * Creates legacy DirectDraw Interfaces. Can't create IDirectDraw7
366 * interfaces in theory
368 * Arguments, return values: See DDRAW_Create
370 ***********************************************************************/
371 HRESULT WINAPI DECLSPEC_HOTPATCH
372 DirectDrawCreate(GUID *GUID,
377 TRACE("(%s,%p,%p)\n", debugstr_guid(GUID), DD, UnkOuter);
379 EnterCriticalSection(&ddraw_cs);
380 hr = DDRAW_Create(GUID, (void **) DD, UnkOuter, &IID_IDirectDraw);
381 LeaveCriticalSection(&ddraw_cs);
385 /***********************************************************************
386 * DirectDrawCreateEx (DDRAW.@)
388 * Only creates new IDirectDraw7 interfaces, supposed to fail if legacy
389 * interfaces are requested.
391 * Arguments, return values: See DDRAW_Create
393 ***********************************************************************/
394 HRESULT WINAPI DECLSPEC_HOTPATCH
395 DirectDrawCreateEx(GUID *GUID,
401 TRACE("(%s,%p,%s,%p)\n", debugstr_guid(GUID), DD, debugstr_guid(iid), UnkOuter);
403 if (!IsEqualGUID(iid, &IID_IDirectDraw7))
404 return DDERR_INVALIDPARAMS;
406 EnterCriticalSection(&ddraw_cs);
407 hr = DDRAW_Create(GUID, DD, UnkOuter, iid);
408 LeaveCriticalSection(&ddraw_cs);
412 /***********************************************************************
413 * DirectDrawEnumerateA (DDRAW.@)
415 * Enumerates legacy ddraw drivers, ascii version. We only have one
416 * driver, which relays to WineD3D. If we were sufficiently cool,
417 * we could offer various interfaces, which use a different default surface
418 * implementation, but I think it's better to offer this choice in
419 * winecfg, because some apps use the default driver, so we would need
420 * a winecfg option anyway, and there shouldn't be 2 ways to set one setting
423 * Callback: Callback function from the app
424 * Context: Argument to the call back.
428 * E_INVALIDARG if the Callback caused a page fault
431 ***********************************************************************/
433 DirectDrawEnumerateA(LPDDENUMCALLBACKA Callback,
436 TRACE("(%p, %p)\n", Callback, Context);
438 TRACE(" Enumerating default DirectDraw HAL interface\n");
439 /* We only have one driver */
442 static CHAR driver_desc[] = "DirectDraw HAL",
443 driver_name[] = "display";
445 Callback(NULL, driver_desc, driver_name, Context);
449 return DDERR_INVALIDPARAMS;
453 TRACE(" End of enumeration\n");
457 /***********************************************************************
458 * DirectDrawEnumerateExA (DDRAW.@)
460 * Enumerates DirectDraw7 drivers, ascii version. See
461 * the comments above DirectDrawEnumerateA for more details.
463 * The Flag member is not supported right now.
465 ***********************************************************************/
467 DirectDrawEnumerateExA(LPDDENUMCALLBACKEXA Callback,
471 TRACE("(%p, %p, 0x%08x)\n", Callback, Context, Flags);
473 if (Flags & ~(DDENUM_ATTACHEDSECONDARYDEVICES |
474 DDENUM_DETACHEDSECONDARYDEVICES |
475 DDENUM_NONDISPLAYDEVICES))
476 return DDERR_INVALIDPARAMS;
479 FIXME("flags 0x%08x not handled\n", Flags);
481 TRACE("Enumerating default DirectDraw HAL interface\n");
483 /* We only have one driver by now */
486 static CHAR driver_desc[] = "DirectDraw HAL",
487 driver_name[] = "display";
489 /* QuickTime expects the description "DirectDraw HAL" */
490 Callback(NULL, driver_desc, driver_name, Context, 0);
494 return DDERR_INVALIDPARAMS;
498 TRACE("End of enumeration\n");
502 /***********************************************************************
503 * DirectDrawEnumerateW (DDRAW.@)
505 * Enumerates legacy drivers, unicode version.
506 * This function is not implemented on Windows.
508 ***********************************************************************/
510 DirectDrawEnumerateW(LPDDENUMCALLBACKW Callback,
513 TRACE("(%p, %p)\n", Callback, Context);
516 return DDERR_INVALIDPARAMS;
518 return DDERR_UNSUPPORTED;
521 /***********************************************************************
522 * DirectDrawEnumerateExW (DDRAW.@)
524 * Enumerates DirectDraw7 drivers, unicode version.
525 * This function is not implemented on Windows.
527 ***********************************************************************/
529 DirectDrawEnumerateExW(LPDDENUMCALLBACKEXW Callback,
533 TRACE("(%p, %p, 0x%x)\n", Callback, Context, Flags);
535 return DDERR_UNSUPPORTED;
538 /***********************************************************************
539 * Classfactory implementation.
540 ***********************************************************************/
542 /***********************************************************************
543 * CF_CreateDirectDraw
545 * DDraw creation function for the class factory
548 * UnkOuter: Set to NULL
549 * iid: ID of the wanted interface
550 * obj: Address to pass the interface pointer back
553 * DD_OK / DDERR*, see DDRAW_Create
555 ***********************************************************************/
557 CF_CreateDirectDraw(IUnknown* UnkOuter, REFIID iid,
562 TRACE("(%p,%s,%p)\n", UnkOuter, debugstr_guid(iid), obj);
564 EnterCriticalSection(&ddraw_cs);
565 hr = DDRAW_Create(NULL, obj, UnkOuter, iid);
566 LeaveCriticalSection(&ddraw_cs);
570 /***********************************************************************
571 * CF_CreateDirectDraw
573 * Clipper creation function for the class factory
576 * UnkOuter: Set to NULL
577 * iid: ID of the wanted interface
578 * obj: Address to pass the interface pointer back
581 * DD_OK / DDERR*, see DDRAW_Create
583 ***********************************************************************/
585 CF_CreateDirectDrawClipper(IUnknown* UnkOuter, REFIID riid,
589 IDirectDrawClipper *Clip;
591 EnterCriticalSection(&ddraw_cs);
592 hr = DirectDrawCreateClipper(0, &Clip, UnkOuter);
595 LeaveCriticalSection(&ddraw_cs);
599 hr = IDirectDrawClipper_QueryInterface(Clip, riid, obj);
600 IDirectDrawClipper_Release(Clip);
602 LeaveCriticalSection(&ddraw_cs);
606 static const struct object_creation_info object_creation[] =
608 { &CLSID_DirectDraw, CF_CreateDirectDraw },
609 { &CLSID_DirectDraw7, CF_CreateDirectDraw },
610 { &CLSID_DirectDrawClipper, CF_CreateDirectDrawClipper }
613 /*******************************************************************************
614 * IDirectDrawClassFactory::QueryInterface
616 * QueryInterface for the class factory
619 * riid Reference to identifier of queried interface
620 * ppv Address to return the interface pointer at
624 * Failure: E_NOINTERFACE
626 *******************************************************************************/
627 static HRESULT WINAPI
628 IDirectDrawClassFactoryImpl_QueryInterface(IClassFactory *iface,
632 IClassFactoryImpl *This = (IClassFactoryImpl *)iface;
634 TRACE("(%p)->(%s,%p)\n", This, debugstr_guid(riid), obj);
636 if (IsEqualGUID(riid, &IID_IUnknown)
637 || IsEqualGUID(riid, &IID_IClassFactory))
639 IClassFactory_AddRef(iface);
644 WARN("(%p)->(%s,%p),not found\n",This,debugstr_guid(riid),obj);
645 return E_NOINTERFACE;
648 /*******************************************************************************
649 * IDirectDrawClassFactory::AddRef
651 * AddRef for the class factory
656 *******************************************************************************/
658 IDirectDrawClassFactoryImpl_AddRef(IClassFactory *iface)
660 IClassFactoryImpl *This = (IClassFactoryImpl *)iface;
661 ULONG ref = InterlockedIncrement(&This->ref);
663 TRACE("(%p)->() incrementing from %d.\n", This, ref - 1);
668 /*******************************************************************************
669 * IDirectDrawClassFactory::Release
671 * Release for the class factory. If the refcount falls to 0, the object
677 *******************************************************************************/
679 IDirectDrawClassFactoryImpl_Release(IClassFactory *iface)
681 IClassFactoryImpl *This = (IClassFactoryImpl *)iface;
682 ULONG ref = InterlockedDecrement(&This->ref);
683 TRACE("(%p)->() decrementing from %d.\n", This, ref+1);
686 HeapFree(GetProcessHeap(), 0, This);
692 /*******************************************************************************
693 * IDirectDrawClassFactory::CreateInstance
695 * What is this? Seems to create DirectDraw objects...
698 * The usual things???
703 *******************************************************************************/
704 static HRESULT WINAPI
705 IDirectDrawClassFactoryImpl_CreateInstance(IClassFactory *iface,
710 IClassFactoryImpl *This = (IClassFactoryImpl *)iface;
712 TRACE("(%p)->(%p,%s,%p)\n",This,UnkOuter,debugstr_guid(riid),obj);
714 return This->pfnCreateInstance(UnkOuter, riid, obj);
717 /*******************************************************************************
718 * IDirectDrawClassFactory::LockServer
726 * S_OK, because it's a stub
728 *******************************************************************************/
729 static HRESULT WINAPI
730 IDirectDrawClassFactoryImpl_LockServer(IClassFactory *iface,BOOL dolock)
732 IClassFactoryImpl *This = (IClassFactoryImpl *)iface;
733 FIXME("(%p)->(%d),stub!\n",This,dolock);
737 /*******************************************************************************
738 * The class factory VTable
739 *******************************************************************************/
740 static const IClassFactoryVtbl IClassFactory_Vtbl =
742 IDirectDrawClassFactoryImpl_QueryInterface,
743 IDirectDrawClassFactoryImpl_AddRef,
744 IDirectDrawClassFactoryImpl_Release,
745 IDirectDrawClassFactoryImpl_CreateInstance,
746 IDirectDrawClassFactoryImpl_LockServer
749 /*******************************************************************************
750 * DllGetClassObject [DDRAW.@]
751 * Retrieves class object from a DLL object
754 * Docs say returns STDAPI
757 * rclsid [I] CLSID for the class object
758 * riid [I] Reference to identifier of interface for class object
759 * ppv [O] Address of variable to receive interface pointer for riid
763 * Failure: CLASS_E_CLASSNOTAVAILABLE, E_OUTOFMEMORY, E_INVALIDARG,
766 HRESULT WINAPI DllGetClassObject(REFCLSID rclsid, REFIID riid, LPVOID *ppv)
769 IClassFactoryImpl *factory;
771 TRACE("(%s,%s,%p)\n", debugstr_guid(rclsid), debugstr_guid(riid), ppv);
773 if ( !IsEqualGUID( &IID_IClassFactory, riid )
774 && ! IsEqualGUID( &IID_IUnknown, riid) )
775 return E_NOINTERFACE;
777 for (i=0; i < sizeof(object_creation)/sizeof(object_creation[0]); i++)
779 if (IsEqualGUID(object_creation[i].clsid, rclsid))
783 if (i == sizeof(object_creation)/sizeof(object_creation[0]))
785 FIXME("%s: no class found.\n", debugstr_guid(rclsid));
786 return CLASS_E_CLASSNOTAVAILABLE;
789 factory = HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, sizeof(*factory));
790 if (factory == NULL) return E_OUTOFMEMORY;
792 factory->lpVtbl = &IClassFactory_Vtbl;
795 factory->pfnCreateInstance = object_creation[i].pfnCreateInstance;
802 /*******************************************************************************
803 * DllCanUnloadNow [DDRAW.@] Determines whether the DLL is in use.
809 HRESULT WINAPI DllCanUnloadNow(void)
814 /*******************************************************************************
817 * Callback function for the EnumSurfaces call in DllMain.
818 * Dumps some surface info and releases the surface
821 * surf: The enumerated surface
822 * desc: it's description
823 * context: Pointer to the ddraw impl
827 *******************************************************************************/
828 static HRESULT WINAPI
829 DestroyCallback(IDirectDrawSurface7 *surf,
830 DDSURFACEDESC2 *desc,
833 IDirectDrawSurfaceImpl *Impl = (IDirectDrawSurfaceImpl *)surf;
836 ref = IDirectDrawSurface7_Release(surf); /* For the EnumSurfaces */
837 WARN("Surface %p has an reference count of %d\n", Impl, ref);
839 /* Skip surfaces which are attached somewhere or which are
840 * part of a complex compound. They will get released when destroying
843 if( (!Impl->is_complex_root) || (Impl->first_attached != Impl) )
846 /* Destroy the surface */
847 while(ref) ref = IDirectDrawSurface7_Release(surf);
852 /***********************************************************************
855 * Reads a config key from the registry. Taken from WineD3D
857 ***********************************************************************/
858 static inline DWORD get_config_key(HKEY defkey, HKEY appkey, const char* name, char* buffer, DWORD size)
860 if (0 != appkey && !RegQueryValueExA( appkey, name, 0, NULL, (LPBYTE) buffer, &size )) return 0;
861 if (0 != defkey && !RegQueryValueExA( defkey, name, 0, NULL, (LPBYTE) buffer, &size )) return 0;
862 return ERROR_FILE_NOT_FOUND;
865 /***********************************************************************
868 * Could be used to register DirectDraw drivers, if we have more than
869 * one. Also used to destroy any objects left at unload if the
870 * app didn't release them properly(Gothic 2, Diablo 2, Moto racer, ...)
872 ***********************************************************************/
874 DllMain(HINSTANCE hInstDLL,
878 TRACE("(%p,%x,%p)\n", hInstDLL, Reason, lpv);
879 if (Reason == DLL_PROCESS_ATTACH)
881 char buffer[MAX_PATH+10];
882 DWORD size = sizeof(buffer);
888 /* Register the window class. This is used to create a hidden window
889 * for D3D rendering, if the application didn't pass one. It can also
890 * be used for creating a device window from SetCooperativeLevel(). */
891 wc.style = CS_HREDRAW | CS_VREDRAW;
892 wc.lpfnWndProc = DefWindowProcA;
895 wc.hInstance = hInstDLL;
898 wc.hbrBackground = GetStockObject(BLACK_BRUSH);
899 wc.lpszMenuName = NULL;
900 wc.lpszClassName = DDRAW_WINDOW_CLASS_NAME;
901 if (!RegisterClassA(&wc))
903 ERR("Failed to register ddraw window class, last error %#x.\n", GetLastError());
907 /* @@ Wine registry key: HKCU\Software\Wine\Direct3D */
908 if ( RegOpenKeyA( HKEY_CURRENT_USER, "Software\\Wine\\Direct3D", &hkey ) ) hkey = 0;
910 len = GetModuleFileNameA( 0, buffer, MAX_PATH );
911 if (len && len < MAX_PATH)
914 /* @@ Wine registry key: HKCU\Software\Wine\AppDefaults\app.exe\Direct3D */
915 if (!RegOpenKeyA( HKEY_CURRENT_USER, "Software\\Wine\\AppDefaults", &tmpkey ))
917 char *p, *appname = buffer;
918 if ((p = strrchr( appname, '/' ))) appname = p + 1;
919 if ((p = strrchr( appname, '\\' ))) appname = p + 1;
920 strcat( appname, "\\Direct3D" );
921 TRACE("appname = [%s]\n", appname);
922 if (RegOpenKeyA( tmpkey, appname, &appkey )) appkey = 0;
923 RegCloseKey( tmpkey );
927 if ( 0 != hkey || 0 != appkey )
929 if ( !get_config_key( hkey, appkey, "DirectDrawRenderer", buffer, size) )
931 if (!strcmp(buffer,"gdi"))
933 TRACE("Defaulting to GDI surfaces\n");
934 DefaultSurfaceType = SURFACE_GDI;
936 else if (!strcmp(buffer,"opengl"))
938 TRACE("Defaulting to opengl surfaces\n");
939 DefaultSurfaceType = SURFACE_OPENGL;
943 ERR("Unknown default surface type. Supported are:\n gdi, opengl\n");
948 /* On Windows one can force the refresh rate that DirectDraw uses by
949 * setting an override value in dxdiag. This is documented in KB315614
950 * (main article), KB230002, and KB217348. By comparing registry dumps
951 * before and after setting the override, we see that the override value
952 * is stored in HKLM\Software\Microsoft\DirectDraw\ForceRefreshRate as a
953 * DWORD that represents the refresh rate to force. We use this
954 * registry entry to modify the behavior of SetDisplayMode so that Wine
955 * users can override the refresh rate in a Windows-compatible way.
957 * dxdiag will not accept a refresh rate lower than 40 or higher than
958 * 120 so this value should be within that range. It is, of course,
959 * possible for a user to set the registry entry value directly so that
960 * assumption might not hold.
962 * There is no current mechanism for setting this value through the Wine
963 * GUI. It would be most appropriate to set this value through a dxdiag
964 * clone, but it may be sufficient to use winecfg.
966 * TODO: Create a mechanism for setting this value through the Wine GUI.
968 if ( !RegOpenKeyA( HKEY_LOCAL_MACHINE, "Software\\Microsoft\\DirectDraw", &hkey ) )
972 if (!RegQueryValueExA( hkey, "ForceRefreshRate", NULL, &type, (LPBYTE)&data, &size ) && type == REG_DWORD)
974 TRACE("ForceRefreshRate set; overriding refresh rate to %d Hz\n", data);
975 force_refresh_rate = data;
980 DisableThreadLibraryCalls(hInstDLL);
982 else if (Reason == DLL_PROCESS_DETACH)
984 if(!list_empty(&global_ddraw_list))
986 struct list *entry, *entry2;
987 WARN("There are still existing DirectDraw interfaces. Wine bug or buggy application?\n");
989 /* We remove elements from this loop */
990 LIST_FOR_EACH_SAFE(entry, entry2, &global_ddraw_list)
995 IDirectDrawImpl *ddraw = LIST_ENTRY(entry, IDirectDrawImpl, ddraw_list_entry);
997 WARN("DDraw %p has a refcount of %d\n", ddraw, ddraw->ref7 + ddraw->ref4 + ddraw->ref3 + ddraw->ref2 + ddraw->ref1);
999 /* Add references to each interface to avoid freeing them unexpectedly */
1000 IDirectDraw_AddRef((IDirectDraw *)&ddraw->IDirectDraw_vtbl);
1001 IDirectDraw2_AddRef((IDirectDraw2 *)&ddraw->IDirectDraw2_vtbl);
1002 IDirectDraw3_AddRef((IDirectDraw3 *)&ddraw->IDirectDraw3_vtbl);
1003 IDirectDraw4_AddRef((IDirectDraw4 *)&ddraw->IDirectDraw4_vtbl);
1004 IDirectDraw7_AddRef((IDirectDraw7 *)ddraw);
1006 /* Does a D3D device exist? Destroy it
1007 * TODO: Destroy all Vertex buffers, Lights, Materials
1008 * and execute buffers too
1010 if(ddraw->d3ddevice)
1012 WARN("DDraw %p has d3ddevice %p attached\n", ddraw, ddraw->d3ddevice);
1013 while(IDirect3DDevice7_Release((IDirect3DDevice7 *)ddraw->d3ddevice));
1016 /* Try to release the objects
1017 * Do an EnumSurfaces to find any hanging surfaces
1019 memset(&desc, 0, sizeof(desc));
1020 desc.dwSize = sizeof(desc);
1021 for(i = 0; i <= 1; i++)
1023 hr = IDirectDraw7_EnumSurfaces((IDirectDraw7 *)ddraw,
1024 DDENUMSURFACES_ALL, &desc, ddraw, DestroyCallback);
1026 ERR("(%p) EnumSurfaces failed, prepare for trouble\n", ddraw);
1029 /* Check the surface count */
1030 if(ddraw->surfaces > 0)
1031 ERR("DDraw %p still has %d surfaces attached\n", ddraw, ddraw->surfaces);
1033 /* Release all hanging references to destroy the objects. This
1034 * restores the screen mode too
1036 while(IDirectDraw_Release((IDirectDraw *)&ddraw->IDirectDraw_vtbl));
1037 while(IDirectDraw2_Release((IDirectDraw2 *)&ddraw->IDirectDraw2_vtbl));
1038 while(IDirectDraw3_Release((IDirectDraw3 *)&ddraw->IDirectDraw3_vtbl));
1039 while(IDirectDraw4_Release((IDirectDraw4 *)&ddraw->IDirectDraw4_vtbl));
1040 while(IDirectDraw7_Release((IDirectDraw7 *)ddraw));
1044 /* Unregister the window class. */
1045 UnregisterClassA(DDRAW_WINDOW_CLASS_NAME, hInstDLL);