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"
34 #include "wine/exception.h"
37 WINE_DEFAULT_DEBUG_CHANNEL(ddraw
);
39 /* The configured default surface */
40 WINED3DSURFTYPE DefaultSurfaceType
= SURFACE_OPENGL
;
42 static struct list global_ddraw_list
= LIST_INIT(global_ddraw_list
);
44 static HINSTANCE instance
;
46 /* value of ForceRefreshRate */
47 DWORD force_refresh_rate
= 0;
49 /* Handle table functions */
50 BOOL
ddraw_handle_table_init(struct ddraw_handle_table
*t
, UINT initial_size
)
52 t
->entries
= HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY
, initial_size
* sizeof(*t
->entries
));
55 ERR("Failed to allocate handle table memory.\n");
58 t
->free_entries
= NULL
;
59 t
->table_size
= initial_size
;
65 void ddraw_handle_table_destroy(struct ddraw_handle_table
*t
)
67 HeapFree(GetProcessHeap(), 0, t
->entries
);
68 memset(t
, 0, sizeof(*t
));
71 DWORD
ddraw_allocate_handle(struct ddraw_handle_table
*t
, void *object
, enum ddraw_handle_type type
)
73 struct ddraw_handle_entry
*entry
;
77 DWORD idx
= t
->free_entries
- t
->entries
;
78 /* Use a free handle */
79 entry
= t
->free_entries
;
80 if (entry
->type
!= DDRAW_HANDLE_FREE
)
82 ERR("Handle %#x (%p) is in the free list, but has type %#x.\n", idx
, entry
->object
, entry
->type
);
83 return DDRAW_INVALID_HANDLE
;
85 t
->free_entries
= entry
->object
;
86 entry
->object
= object
;
92 if (!(t
->entry_count
< t
->table_size
))
95 UINT new_size
= t
->table_size
+ (t
->table_size
>> 1);
96 struct ddraw_handle_entry
*new_entries
= HeapReAlloc(GetProcessHeap(),
97 0, t
->entries
, new_size
* sizeof(*t
->entries
));
100 ERR("Failed to grow the handle table.\n");
101 return DDRAW_INVALID_HANDLE
;
103 t
->entries
= new_entries
;
104 t
->table_size
= new_size
;
107 entry
= &t
->entries
[t
->entry_count
];
108 entry
->object
= object
;
111 return t
->entry_count
++;
114 void *ddraw_free_handle(struct ddraw_handle_table
*t
, DWORD handle
, enum ddraw_handle_type type
)
116 struct ddraw_handle_entry
*entry
;
119 if (handle
== DDRAW_INVALID_HANDLE
|| handle
>= t
->entry_count
)
121 WARN("Invalid handle %#x passed.\n", handle
);
125 entry
= &t
->entries
[handle
];
126 if (entry
->type
!= type
)
128 WARN("Handle %#x (%p) is not of type %#x.\n", handle
, entry
->object
, type
);
132 object
= entry
->object
;
133 entry
->object
= t
->free_entries
;
134 entry
->type
= DDRAW_HANDLE_FREE
;
135 t
->free_entries
= entry
;
140 void *ddraw_get_object(struct ddraw_handle_table
*t
, DWORD handle
, enum ddraw_handle_type type
)
142 struct ddraw_handle_entry
*entry
;
144 if (handle
== DDRAW_INVALID_HANDLE
|| handle
>= t
->entry_count
)
146 WARN("Invalid handle %#x passed.\n", handle
);
150 entry
= &t
->entries
[handle
];
151 if (entry
->type
!= type
)
153 WARN("Handle %#x (%p) is not of type %#x.\n", handle
, entry
->object
, type
);
157 return entry
->object
;
160 /***********************************************************************
162 * Helper function for DirectDrawCreate and friends
163 * Creates a new DDraw interface with the given REFIID
165 * Interfaces that can be created:
166 * IDirectDraw, IDirectDraw2, IDirectDraw4, IDirectDraw7
167 * IDirect3D, IDirect3D2, IDirect3D3, IDirect3D7. (Does Windows return
168 * IDirect3D interfaces?)
171 * guid: ID of the requested driver, NULL for the default driver.
172 * The GUID can be queried with DirectDrawEnumerate(Ex)A/W
173 * DD: Used to return the pointer to the created object
174 * UnkOuter: For aggregation, which is unsupported. Must be NULL
175 * iid: requested version ID.
178 * DD_OK if the Interface was created successfully
179 * CLASS_E_NOAGGREGATION if UnkOuter is not NULL
180 * E_OUTOFMEMORY if some allocation failed
182 ***********************************************************************/
184 DDRAW_Create(const GUID
*guid
,
189 WINED3DDEVTYPE devicetype
;
190 IDirectDrawImpl
*This
;
193 TRACE("driver_guid %s, ddraw %p, outer_unknown %p, interface_iid %s.\n",
194 debugstr_guid(guid
), DD
, UnkOuter
, debugstr_guid(iid
));
198 /* We don't care about this guids. Well, there's no special guid anyway
201 if (guid
== (GUID
*) DDCREATE_EMULATIONONLY
)
203 /* Use the reference device id. This doesn't actually change anything,
204 * WineD3D always uses OpenGL for D3D rendering. One could make it request
207 devicetype
= WINED3DDEVTYPE_REF
;
209 else if(guid
== (GUID
*) DDCREATE_HARDWAREONLY
)
211 devicetype
= WINED3DDEVTYPE_HAL
;
218 /* DDraw doesn't support aggregation, according to msdn */
219 if (UnkOuter
!= NULL
)
220 return CLASS_E_NOAGGREGATION
;
222 /* DirectDraw creation comes here */
223 This
= HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY
, sizeof(IDirectDrawImpl
));
226 ERR("Out of memory when creating DirectDraw\n");
227 return E_OUTOFMEMORY
;
230 hr
= ddraw_init(This
, devicetype
);
233 WARN("Failed to initialize ddraw object, hr %#x.\n", hr
);
234 HeapFree(GetProcessHeap(), 0, This
);
238 hr
= IDirectDraw7_QueryInterface(&This
->IDirectDraw7_iface
, iid
, DD
);
239 IDirectDraw7_Release(&This
->IDirectDraw7_iface
);
240 if (SUCCEEDED(hr
)) list_add_head(&global_ddraw_list
, &This
->ddraw_list_entry
);
241 else WARN("Failed to query interface %s from ddraw object %p.\n", debugstr_guid(iid
), This
);
246 /***********************************************************************
247 * DirectDrawCreate (DDRAW.@)
249 * Creates legacy DirectDraw Interfaces. Can't create IDirectDraw7
250 * interfaces in theory
252 * Arguments, return values: See DDRAW_Create
254 ***********************************************************************/
255 HRESULT WINAPI DECLSPEC_HOTPATCH
256 DirectDrawCreate(GUID
*GUID
,
262 TRACE("driver_guid %s, ddraw %p, outer_unknown %p.\n",
263 debugstr_guid(GUID
), DD
, UnkOuter
);
265 wined3d_mutex_lock();
266 hr
= DDRAW_Create(GUID
, (void **) DD
, UnkOuter
, &IID_IDirectDraw
);
267 wined3d_mutex_unlock();
271 hr
= IDirectDraw_Initialize(*DD
, GUID
);
273 IDirectDraw_Release(*DD
);
279 /***********************************************************************
280 * DirectDrawCreateEx (DDRAW.@)
282 * Only creates new IDirectDraw7 interfaces, supposed to fail if legacy
283 * interfaces are requested.
285 * Arguments, return values: See DDRAW_Create
287 ***********************************************************************/
288 HRESULT WINAPI DECLSPEC_HOTPATCH
289 DirectDrawCreateEx(GUID
*guid
,
296 TRACE("driver_guid %s, ddraw %p, interface_iid %s, outer_unknown %p.\n",
297 debugstr_guid(guid
), dd
, debugstr_guid(iid
), UnkOuter
);
299 if (!IsEqualGUID(iid
, &IID_IDirectDraw7
))
300 return DDERR_INVALIDPARAMS
;
302 wined3d_mutex_lock();
303 hr
= DDRAW_Create(guid
, dd
, UnkOuter
, iid
);
304 wined3d_mutex_unlock();
308 IDirectDraw7
*ddraw7
= *(IDirectDraw7
**)dd
;
309 hr
= IDirectDraw7_Initialize(ddraw7
, guid
);
311 IDirectDraw7_Release(ddraw7
);
317 /***********************************************************************
318 * DirectDrawEnumerateA (DDRAW.@)
320 * Enumerates legacy ddraw drivers, ascii version. We only have one
321 * driver, which relays to WineD3D. If we were sufficiently cool,
322 * we could offer various interfaces, which use a different default surface
323 * implementation, but I think it's better to offer this choice in
324 * winecfg, because some apps use the default driver, so we would need
325 * a winecfg option anyway, and there shouldn't be 2 ways to set one setting
328 * Callback: Callback function from the app
329 * Context: Argument to the call back.
333 * E_INVALIDARG if the Callback caused a page fault
336 ***********************************************************************/
337 HRESULT WINAPI
DirectDrawEnumerateA(LPDDENUMCALLBACKA Callback
, void *Context
)
339 TRACE("callback %p, context %p.\n", Callback
, Context
);
341 TRACE(" Enumerating default DirectDraw HAL interface\n");
342 /* We only have one driver */
345 static CHAR driver_desc
[] = "DirectDraw HAL",
346 driver_name
[] = "display";
348 Callback(NULL
, driver_desc
, driver_name
, Context
);
352 return DDERR_INVALIDPARAMS
;
356 TRACE(" End of enumeration\n");
360 /***********************************************************************
361 * DirectDrawEnumerateExA (DDRAW.@)
363 * Enumerates DirectDraw7 drivers, ascii version. See
364 * the comments above DirectDrawEnumerateA for more details.
366 * The Flag member is not supported right now.
368 ***********************************************************************/
369 HRESULT WINAPI
DirectDrawEnumerateExA(LPDDENUMCALLBACKEXA Callback
, void *Context
, DWORD Flags
)
371 TRACE("callback %p, context %p, flags %#x.\n", Callback
, Context
, Flags
);
373 if (Flags
& ~(DDENUM_ATTACHEDSECONDARYDEVICES
|
374 DDENUM_DETACHEDSECONDARYDEVICES
|
375 DDENUM_NONDISPLAYDEVICES
))
376 return DDERR_INVALIDPARAMS
;
379 FIXME("flags 0x%08x not handled\n", Flags
);
381 TRACE("Enumerating default DirectDraw HAL interface\n");
383 /* We only have one driver by now */
386 static CHAR driver_desc
[] = "DirectDraw HAL",
387 driver_name
[] = "display";
389 /* QuickTime expects the description "DirectDraw HAL" */
390 Callback(NULL
, driver_desc
, driver_name
, Context
, 0);
394 return DDERR_INVALIDPARAMS
;
398 TRACE("End of enumeration\n");
402 /***********************************************************************
403 * DirectDrawEnumerateW (DDRAW.@)
405 * Enumerates legacy drivers, unicode version.
406 * This function is not implemented on Windows.
408 ***********************************************************************/
409 HRESULT WINAPI
DirectDrawEnumerateW(LPDDENUMCALLBACKW callback
, void *context
)
411 TRACE("callback %p, context %p.\n", callback
, context
);
414 return DDERR_INVALIDPARAMS
;
416 return DDERR_UNSUPPORTED
;
419 /***********************************************************************
420 * DirectDrawEnumerateExW (DDRAW.@)
422 * Enumerates DirectDraw7 drivers, unicode version.
423 * This function is not implemented on Windows.
425 ***********************************************************************/
426 HRESULT WINAPI
DirectDrawEnumerateExW(LPDDENUMCALLBACKEXW callback
, void *context
, DWORD flags
)
428 TRACE("callback %p, context %p, flags %#x.\n", callback
, context
, flags
);
430 return DDERR_UNSUPPORTED
;
433 /***********************************************************************
434 * Classfactory implementation.
435 ***********************************************************************/
437 /***********************************************************************
438 * CF_CreateDirectDraw
440 * DDraw creation function for the class factory
443 * UnkOuter: Set to NULL
444 * iid: ID of the wanted interface
445 * obj: Address to pass the interface pointer back
448 * DD_OK / DDERR*, see DDRAW_Create
450 ***********************************************************************/
452 CF_CreateDirectDraw(IUnknown
* UnkOuter
, REFIID iid
,
457 TRACE("outer_unknown %p, riid %s, object %p.\n", UnkOuter
, debugstr_guid(iid
), obj
);
459 wined3d_mutex_lock();
460 hr
= DDRAW_Create(NULL
, obj
, UnkOuter
, iid
);
461 wined3d_mutex_unlock();
466 /***********************************************************************
467 * CF_CreateDirectDraw
469 * Clipper creation function for the class factory
472 * UnkOuter: Set to NULL
473 * iid: ID of the wanted interface
474 * obj: Address to pass the interface pointer back
477 * DD_OK / DDERR*, see DDRAW_Create
479 ***********************************************************************/
481 CF_CreateDirectDrawClipper(IUnknown
* UnkOuter
, REFIID riid
,
485 IDirectDrawClipper
*Clip
;
487 TRACE("outer_unknown %p, riid %s, object %p.\n", UnkOuter
, debugstr_guid(riid
), obj
);
489 wined3d_mutex_lock();
490 hr
= DirectDrawCreateClipper(0, &Clip
, UnkOuter
);
493 wined3d_mutex_unlock();
497 hr
= IDirectDrawClipper_QueryInterface(Clip
, riid
, obj
);
498 IDirectDrawClipper_Release(Clip
);
500 wined3d_mutex_unlock();
505 static const struct object_creation_info object_creation
[] =
507 { &CLSID_DirectDraw
, CF_CreateDirectDraw
},
508 { &CLSID_DirectDraw7
, CF_CreateDirectDraw
},
509 { &CLSID_DirectDrawClipper
, CF_CreateDirectDrawClipper
}
513 /******************************************************************************
514 * DirectDraw ClassFactory implementation
515 ******************************************************************************/
518 IClassFactory IClassFactory_iface
;
521 HRESULT (*pfnCreateInstance
)(IUnknown
*pUnkOuter
, REFIID iid
, LPVOID
*ppObj
);
524 static inline IClassFactoryImpl
*impl_from_IClassFactory(IClassFactory
*iface
)
526 return CONTAINING_RECORD(iface
, IClassFactoryImpl
, IClassFactory_iface
);
529 /*******************************************************************************
530 * IDirectDrawClassFactory::QueryInterface
532 * QueryInterface for the class factory
535 * riid Reference to identifier of queried interface
536 * ppv Address to return the interface pointer at
540 * Failure: E_NOINTERFACE
542 *******************************************************************************/
543 static HRESULT WINAPI
IDirectDrawClassFactoryImpl_QueryInterface(IClassFactory
*iface
, REFIID riid
,
546 IClassFactoryImpl
*This
= impl_from_IClassFactory(iface
);
548 TRACE("iface %p, riid %s, object %p.\n", iface
, debugstr_guid(riid
), obj
);
550 if (IsEqualGUID(riid
, &IID_IUnknown
)
551 || IsEqualGUID(riid
, &IID_IClassFactory
))
553 IClassFactory_AddRef(iface
);
558 WARN("(%p)->(%s,%p),not found\n",This
,debugstr_guid(riid
),obj
);
559 return E_NOINTERFACE
;
562 /*******************************************************************************
563 * IDirectDrawClassFactory::AddRef
565 * AddRef for the class factory
570 *******************************************************************************/
571 static ULONG WINAPI
IDirectDrawClassFactoryImpl_AddRef(IClassFactory
*iface
)
573 IClassFactoryImpl
*This
= impl_from_IClassFactory(iface
);
574 ULONG ref
= InterlockedIncrement(&This
->ref
);
576 TRACE("%p increasing refcount to %u.\n", This
, ref
);
581 /*******************************************************************************
582 * IDirectDrawClassFactory::Release
584 * Release for the class factory. If the refcount falls to 0, the object
590 *******************************************************************************/
591 static ULONG WINAPI
IDirectDrawClassFactoryImpl_Release(IClassFactory
*iface
)
593 IClassFactoryImpl
*This
= impl_from_IClassFactory(iface
);
594 ULONG ref
= InterlockedDecrement(&This
->ref
);
596 TRACE("%p decreasing refcount to %u.\n", This
, ref
);
599 HeapFree(GetProcessHeap(), 0, This
);
605 /*******************************************************************************
606 * IDirectDrawClassFactory::CreateInstance
608 * What is this? Seems to create DirectDraw objects...
611 * The usual things???
616 *******************************************************************************/
617 static HRESULT WINAPI
IDirectDrawClassFactoryImpl_CreateInstance(IClassFactory
*iface
,
618 IUnknown
*UnkOuter
, REFIID riid
, void **obj
)
620 IClassFactoryImpl
*This
= impl_from_IClassFactory(iface
);
622 TRACE("iface %p, outer_unknown %p, riid %s, object %p.\n",
623 iface
, UnkOuter
, debugstr_guid(riid
), obj
);
625 return This
->pfnCreateInstance(UnkOuter
, riid
, obj
);
628 /*******************************************************************************
629 * IDirectDrawClassFactory::LockServer
637 * S_OK, because it's a stub
639 *******************************************************************************/
640 static HRESULT WINAPI
IDirectDrawClassFactoryImpl_LockServer(IClassFactory
*iface
, BOOL dolock
)
642 FIXME("iface %p, dolock %#x stub!\n", iface
, 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("rclsid %s, riid %s, object %p.\n",
682 debugstr_guid(rclsid
), debugstr_guid(riid
), ppv
);
684 if (!IsEqualGUID(&IID_IClassFactory
, riid
)
685 && !IsEqualGUID(&IID_IUnknown
, riid
))
686 return E_NOINTERFACE
;
688 for (i
=0; i
< sizeof(object_creation
)/sizeof(object_creation
[0]); i
++)
690 if (IsEqualGUID(object_creation
[i
].clsid
, rclsid
))
694 if (i
== sizeof(object_creation
)/sizeof(object_creation
[0]))
696 FIXME("%s: no class found.\n", debugstr_guid(rclsid
));
697 return CLASS_E_CLASSNOTAVAILABLE
;
700 factory
= HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY
, sizeof(*factory
));
701 if (factory
== NULL
) return E_OUTOFMEMORY
;
703 factory
->IClassFactory_iface
.lpVtbl
= &IClassFactory_Vtbl
;
706 factory
->pfnCreateInstance
= object_creation
[i
].pfnCreateInstance
;
713 /*******************************************************************************
714 * DllCanUnloadNow [DDRAW.@] Determines whether the DLL is in use.
720 HRESULT WINAPI
DllCanUnloadNow(void)
728 /***********************************************************************
729 * DllRegisterServer (DDRAW.@)
731 HRESULT WINAPI
DllRegisterServer(void)
733 return __wine_register_resources( instance
);
736 /***********************************************************************
737 * DllUnregisterServer (DDRAW.@)
739 HRESULT WINAPI
DllUnregisterServer(void)
741 return __wine_unregister_resources( instance
);
744 /*******************************************************************************
747 * Callback function for the EnumSurfaces call in DllMain.
748 * Dumps some surface info and releases the surface
751 * surf: The enumerated surface
752 * desc: it's description
753 * context: Pointer to the ddraw impl
757 *******************************************************************************/
758 static HRESULT WINAPI
759 DestroyCallback(IDirectDrawSurface7
*surf
,
760 DDSURFACEDESC2
*desc
,
763 IDirectDrawSurfaceImpl
*Impl
= impl_from_IDirectDrawSurface7(surf
);
764 ULONG ref7
, ref4
, ref3
, ref2
, ref1
, gamma_count
, iface_count
;
766 ref7
= IDirectDrawSurface7_Release(surf
); /* For the EnumSurfaces */
767 IDirectDrawSurface4_AddRef(&Impl
->IDirectDrawSurface4_iface
);
768 ref4
= IDirectDrawSurface4_Release(&Impl
->IDirectDrawSurface4_iface
);
769 IDirectDrawSurface3_AddRef(&Impl
->IDirectDrawSurface3_iface
);
770 ref3
= IDirectDrawSurface3_Release(&Impl
->IDirectDrawSurface3_iface
);
771 IDirectDrawSurface2_AddRef(&Impl
->IDirectDrawSurface2_iface
);
772 ref2
= IDirectDrawSurface2_Release(&Impl
->IDirectDrawSurface2_iface
);
773 IDirectDrawSurface_AddRef(&Impl
->IDirectDrawSurface_iface
);
774 ref1
= IDirectDrawSurface_Release(&Impl
->IDirectDrawSurface_iface
);
775 IDirectDrawGammaControl_AddRef(&Impl
->IDirectDrawGammaControl_iface
);
776 gamma_count
= IDirectDrawGammaControl_Release(&Impl
->IDirectDrawGammaControl_iface
);
777 WARN("Surface %p has an reference counts of 7: %u 4: %u 3: %u 2: %u 1: %u gamma: %u\n",
778 Impl
, ref7
, ref4
, ref3
, ref2
, ref1
, gamma_count
);
780 /* Skip surfaces which are attached somewhere or which are
781 * part of a complex compound. They will get released when destroying
784 if( (!Impl
->is_complex_root
) || (Impl
->first_attached
!= Impl
) )
787 /* Destroy the surface */
788 iface_count
= ddraw_surface_release_iface(Impl
);
789 while (iface_count
) iface_count
= ddraw_surface_release_iface(Impl
);
794 /***********************************************************************
797 * Reads a config key from the registry. Taken from WineD3D
799 ***********************************************************************/
800 static inline DWORD
get_config_key(HKEY defkey
, HKEY appkey
, const char* name
, char* buffer
, DWORD size
)
802 if (0 != appkey
&& !RegQueryValueExA( appkey
, name
, 0, NULL
, (LPBYTE
) buffer
, &size
)) return 0;
803 if (0 != defkey
&& !RegQueryValueExA( defkey
, name
, 0, NULL
, (LPBYTE
) buffer
, &size
)) return 0;
804 return ERROR_FILE_NOT_FOUND
;
807 /***********************************************************************
810 * Could be used to register DirectDraw drivers, if we have more than
811 * one. Also used to destroy any objects left at unload if the
812 * app didn't release them properly(Gothic 2, Diablo 2, Moto racer, ...)
814 ***********************************************************************/
816 DllMain(HINSTANCE hInstDLL
,
820 TRACE("(%p,%x,%p)\n", hInstDLL
, Reason
, lpv
);
821 if (Reason
== DLL_PROCESS_ATTACH
)
823 char buffer
[MAX_PATH
+10];
824 DWORD size
= sizeof(buffer
);
830 /* Register the window class. This is used to create a hidden window
831 * for D3D rendering, if the application didn't pass one. It can also
832 * be used for creating a device window from SetCooperativeLevel(). */
833 wc
.style
= CS_HREDRAW
| CS_VREDRAW
;
834 wc
.lpfnWndProc
= DefWindowProcA
;
837 wc
.hInstance
= hInstDLL
;
840 wc
.hbrBackground
= GetStockObject(BLACK_BRUSH
);
841 wc
.lpszMenuName
= NULL
;
842 wc
.lpszClassName
= DDRAW_WINDOW_CLASS_NAME
;
843 if (!RegisterClassA(&wc
))
845 ERR("Failed to register ddraw window class, last error %#x.\n", GetLastError());
849 /* @@ Wine registry key: HKCU\Software\Wine\Direct3D */
850 if ( RegOpenKeyA( HKEY_CURRENT_USER
, "Software\\Wine\\Direct3D", &hkey
) ) hkey
= 0;
852 len
= GetModuleFileNameA( 0, buffer
, MAX_PATH
);
853 if (len
&& len
< MAX_PATH
)
856 /* @@ Wine registry key: HKCU\Software\Wine\AppDefaults\app.exe\Direct3D */
857 if (!RegOpenKeyA( HKEY_CURRENT_USER
, "Software\\Wine\\AppDefaults", &tmpkey
))
859 char *p
, *appname
= buffer
;
860 if ((p
= strrchr( appname
, '/' ))) appname
= p
+ 1;
861 if ((p
= strrchr( appname
, '\\' ))) appname
= p
+ 1;
862 strcat( appname
, "\\Direct3D" );
863 TRACE("appname = [%s]\n", appname
);
864 if (RegOpenKeyA( tmpkey
, appname
, &appkey
)) appkey
= 0;
865 RegCloseKey( tmpkey
);
869 if ( 0 != hkey
|| 0 != appkey
)
871 if ( !get_config_key( hkey
, appkey
, "DirectDrawRenderer", buffer
, size
) )
873 if (!strcmp(buffer
,"gdi"))
875 TRACE("Defaulting to GDI surfaces\n");
876 DefaultSurfaceType
= SURFACE_GDI
;
878 else if (!strcmp(buffer
,"opengl"))
880 TRACE("Defaulting to opengl surfaces\n");
881 DefaultSurfaceType
= SURFACE_OPENGL
;
885 ERR("Unknown default surface type. Supported are:\n gdi, opengl\n");
890 /* On Windows one can force the refresh rate that DirectDraw uses by
891 * setting an override value in dxdiag. This is documented in KB315614
892 * (main article), KB230002, and KB217348. By comparing registry dumps
893 * before and after setting the override, we see that the override value
894 * is stored in HKLM\Software\Microsoft\DirectDraw\ForceRefreshRate as a
895 * DWORD that represents the refresh rate to force. We use this
896 * registry entry to modify the behavior of SetDisplayMode so that Wine
897 * users can override the refresh rate in a Windows-compatible way.
899 * dxdiag will not accept a refresh rate lower than 40 or higher than
900 * 120 so this value should be within that range. It is, of course,
901 * possible for a user to set the registry entry value directly so that
902 * assumption might not hold.
904 * There is no current mechanism for setting this value through the Wine
905 * GUI. It would be most appropriate to set this value through a dxdiag
906 * clone, but it may be sufficient to use winecfg.
908 * TODO: Create a mechanism for setting this value through the Wine GUI.
910 if ( !RegOpenKeyA( HKEY_LOCAL_MACHINE
, "Software\\Microsoft\\DirectDraw", &hkey
) )
914 if (!RegQueryValueExA( hkey
, "ForceRefreshRate", NULL
, &type
, (LPBYTE
)&data
, &size
) && type
== REG_DWORD
)
916 TRACE("ForceRefreshRate set; overriding refresh rate to %d Hz\n", data
);
917 force_refresh_rate
= data
;
923 DisableThreadLibraryCalls(hInstDLL
);
925 else if (Reason
== DLL_PROCESS_DETACH
)
927 if(!list_empty(&global_ddraw_list
))
929 struct list
*entry
, *entry2
;
930 WARN("There are still existing DirectDraw interfaces. Wine bug or buggy application?\n");
932 /* We remove elements from this loop */
933 LIST_FOR_EACH_SAFE(entry
, entry2
, &global_ddraw_list
)
938 IDirectDrawImpl
*ddraw
= LIST_ENTRY(entry
, IDirectDrawImpl
, ddraw_list_entry
);
940 WARN("DDraw %p has a refcount of %d\n", ddraw
, ddraw
->ref7
+ ddraw
->ref4
+ ddraw
->ref3
+ ddraw
->ref2
+ ddraw
->ref1
);
942 /* Add references to each interface to avoid freeing them unexpectedly */
943 IDirectDraw_AddRef(&ddraw
->IDirectDraw_iface
);
944 IDirectDraw2_AddRef(&ddraw
->IDirectDraw2_iface
);
945 IDirectDraw4_AddRef(&ddraw
->IDirectDraw4_iface
);
946 IDirectDraw7_AddRef(&ddraw
->IDirectDraw7_iface
);
948 /* Does a D3D device exist? Destroy it
949 * TODO: Destroy all Vertex buffers, Lights, Materials
950 * and execute buffers too
954 WARN("DDraw %p has d3ddevice %p attached\n", ddraw
, ddraw
->d3ddevice
);
955 while(IDirect3DDevice7_Release(&ddraw
->d3ddevice
->IDirect3DDevice7_iface
));
958 /* Try to release the objects
959 * Do an EnumSurfaces to find any hanging surfaces
961 memset(&desc
, 0, sizeof(desc
));
962 desc
.dwSize
= sizeof(desc
);
963 for(i
= 0; i
<= 1; i
++)
965 hr
= IDirectDraw7_EnumSurfaces(&ddraw
->IDirectDraw7_iface
, DDENUMSURFACES_ALL
,
966 &desc
, ddraw
, DestroyCallback
);
968 ERR("(%p) EnumSurfaces failed, prepare for trouble\n", ddraw
);
971 if (!list_empty(&ddraw
->surface_list
))
972 ERR("DDraw %p still has surfaces attached.\n", ddraw
);
974 /* Release all hanging references to destroy the objects. This
975 * restores the screen mode too
977 while(IDirectDraw_Release(&ddraw
->IDirectDraw_iface
));
978 while(IDirectDraw2_Release(&ddraw
->IDirectDraw2_iface
));
979 while(IDirectDraw4_Release(&ddraw
->IDirectDraw4_iface
));
980 while(IDirectDraw7_Release(&ddraw
->IDirectDraw7_iface
));
984 /* Unregister the window class. */
985 UnregisterClassA(DDRAW_WINDOW_CLASS_NAME
, hInstDLL
);