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 enum wined3d_surface_type DefaultSurfaceType
= WINED3D_SURFACE_TYPE_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 /* Structure for converting DirectDrawEnumerateA to DirectDrawEnumerateExA */
52 LPDDENUMCALLBACKA callback
;
56 /* Enumeration callback for converting DirectDrawEnumerateA to DirectDrawEnumerateExA */
57 static HRESULT CALLBACK
enum_callback(GUID
*guid
, char *description
, char *driver_name
,
58 void *context
, HMONITOR monitor
)
60 const struct callback_info
*info
= context
;
62 return info
->callback(guid
, description
, driver_name
, info
->context
);
65 /* Handle table functions */
66 BOOL
ddraw_handle_table_init(struct ddraw_handle_table
*t
, UINT initial_size
)
68 t
->entries
= HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY
, initial_size
* sizeof(*t
->entries
));
71 ERR("Failed to allocate handle table memory.\n");
74 t
->free_entries
= NULL
;
75 t
->table_size
= initial_size
;
81 void ddraw_handle_table_destroy(struct ddraw_handle_table
*t
)
83 HeapFree(GetProcessHeap(), 0, t
->entries
);
84 memset(t
, 0, sizeof(*t
));
87 DWORD
ddraw_allocate_handle(struct ddraw_handle_table
*t
, void *object
, enum ddraw_handle_type type
)
89 struct ddraw_handle_entry
*entry
;
93 DWORD idx
= t
->free_entries
- t
->entries
;
94 /* Use a free handle */
95 entry
= t
->free_entries
;
96 if (entry
->type
!= DDRAW_HANDLE_FREE
)
98 ERR("Handle %#x (%p) is in the free list, but has type %#x.\n", idx
, entry
->object
, entry
->type
);
99 return DDRAW_INVALID_HANDLE
;
101 t
->free_entries
= entry
->object
;
102 entry
->object
= object
;
108 if (!(t
->entry_count
< t
->table_size
))
111 UINT new_size
= t
->table_size
+ (t
->table_size
>> 1);
112 struct ddraw_handle_entry
*new_entries
= HeapReAlloc(GetProcessHeap(),
113 0, t
->entries
, new_size
* sizeof(*t
->entries
));
116 ERR("Failed to grow the handle table.\n");
117 return DDRAW_INVALID_HANDLE
;
119 t
->entries
= new_entries
;
120 t
->table_size
= new_size
;
123 entry
= &t
->entries
[t
->entry_count
];
124 entry
->object
= object
;
127 return t
->entry_count
++;
130 void *ddraw_free_handle(struct ddraw_handle_table
*t
, DWORD handle
, enum ddraw_handle_type type
)
132 struct ddraw_handle_entry
*entry
;
135 if (handle
== DDRAW_INVALID_HANDLE
|| handle
>= t
->entry_count
)
137 WARN("Invalid handle %#x passed.\n", handle
);
141 entry
= &t
->entries
[handle
];
142 if (entry
->type
!= type
)
144 WARN("Handle %#x (%p) is not of type %#x.\n", handle
, entry
->object
, type
);
148 object
= entry
->object
;
149 entry
->object
= t
->free_entries
;
150 entry
->type
= DDRAW_HANDLE_FREE
;
151 t
->free_entries
= entry
;
156 void *ddraw_get_object(struct ddraw_handle_table
*t
, DWORD handle
, enum ddraw_handle_type type
)
158 struct ddraw_handle_entry
*entry
;
160 if (handle
== DDRAW_INVALID_HANDLE
|| handle
>= t
->entry_count
)
162 WARN("Invalid handle %#x passed.\n", handle
);
166 entry
= &t
->entries
[handle
];
167 if (entry
->type
!= type
)
169 WARN("Handle %#x (%p) is not of type %#x.\n", handle
, entry
->object
, type
);
173 return entry
->object
;
176 /***********************************************************************
178 * Helper function for DirectDrawCreate and friends
179 * Creates a new DDraw interface with the given REFIID
181 * Interfaces that can be created:
182 * IDirectDraw, IDirectDraw2, IDirectDraw4, IDirectDraw7
183 * IDirect3D, IDirect3D2, IDirect3D3, IDirect3D7. (Does Windows return
184 * IDirect3D interfaces?)
187 * guid: ID of the requested driver, NULL for the default driver.
188 * The GUID can be queried with DirectDrawEnumerate(Ex)A/W
189 * DD: Used to return the pointer to the created object
190 * UnkOuter: For aggregation, which is unsupported. Must be NULL
191 * iid: requested version ID.
194 * DD_OK if the Interface was created successfully
195 * CLASS_E_NOAGGREGATION if UnkOuter is not NULL
196 * E_OUTOFMEMORY if some allocation failed
198 ***********************************************************************/
200 DDRAW_Create(const GUID
*guid
,
205 enum wined3d_device_type device_type
;
209 TRACE("driver_guid %s, ddraw %p, outer_unknown %p, interface_iid %s.\n",
210 debugstr_guid(guid
), DD
, UnkOuter
, debugstr_guid(iid
));
214 /* We don't care about this guids. Well, there's no special guid anyway
217 if (guid
== (GUID
*) DDCREATE_EMULATIONONLY
)
219 /* Use the reference device id. This doesn't actually change anything,
220 * WineD3D always uses OpenGL for D3D rendering. One could make it request
223 device_type
= WINED3D_DEVICE_TYPE_REF
;
225 else if(guid
== (GUID
*) DDCREATE_HARDWAREONLY
)
227 device_type
= WINED3D_DEVICE_TYPE_HAL
;
234 /* DDraw doesn't support aggregation, according to msdn */
235 if (UnkOuter
!= NULL
)
236 return CLASS_E_NOAGGREGATION
;
238 /* DirectDraw creation comes here */
239 ddraw
= HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY
, sizeof(*ddraw
));
242 ERR("Out of memory when creating DirectDraw\n");
243 return E_OUTOFMEMORY
;
246 hr
= ddraw_init(ddraw
, device_type
);
249 WARN("Failed to initialize ddraw object, hr %#x.\n", hr
);
250 HeapFree(GetProcessHeap(), 0, ddraw
);
254 hr
= IDirectDraw7_QueryInterface(&ddraw
->IDirectDraw7_iface
, iid
, DD
);
255 IDirectDraw7_Release(&ddraw
->IDirectDraw7_iface
);
257 list_add_head(&global_ddraw_list
, &ddraw
->ddraw_list_entry
);
259 WARN("Failed to query interface %s from ddraw object %p.\n", debugstr_guid(iid
), ddraw
);
264 /***********************************************************************
265 * DirectDrawCreate (DDRAW.@)
267 * Creates legacy DirectDraw Interfaces. Can't create IDirectDraw7
268 * interfaces in theory
270 * Arguments, return values: See DDRAW_Create
272 ***********************************************************************/
273 HRESULT WINAPI DECLSPEC_HOTPATCH
274 DirectDrawCreate(GUID
*GUID
,
280 TRACE("driver_guid %s, ddraw %p, outer_unknown %p.\n",
281 debugstr_guid(GUID
), DD
, UnkOuter
);
283 wined3d_mutex_lock();
284 hr
= DDRAW_Create(GUID
, (void **) DD
, UnkOuter
, &IID_IDirectDraw
);
285 wined3d_mutex_unlock();
289 hr
= IDirectDraw_Initialize(*DD
, GUID
);
291 IDirectDraw_Release(*DD
);
297 /***********************************************************************
298 * DirectDrawCreateEx (DDRAW.@)
300 * Only creates new IDirectDraw7 interfaces, supposed to fail if legacy
301 * interfaces are requested.
303 * Arguments, return values: See DDRAW_Create
305 ***********************************************************************/
306 HRESULT WINAPI DECLSPEC_HOTPATCH
307 DirectDrawCreateEx(GUID
*guid
,
314 TRACE("driver_guid %s, ddraw %p, interface_iid %s, outer_unknown %p.\n",
315 debugstr_guid(guid
), dd
, debugstr_guid(iid
), UnkOuter
);
317 if (!IsEqualGUID(iid
, &IID_IDirectDraw7
))
318 return DDERR_INVALIDPARAMS
;
320 wined3d_mutex_lock();
321 hr
= DDRAW_Create(guid
, dd
, UnkOuter
, iid
);
322 wined3d_mutex_unlock();
326 IDirectDraw7
*ddraw7
= *(IDirectDraw7
**)dd
;
327 hr
= IDirectDraw7_Initialize(ddraw7
, guid
);
329 IDirectDraw7_Release(ddraw7
);
335 /***********************************************************************
336 * DirectDrawEnumerateA (DDRAW.@)
338 * Enumerates legacy ddraw drivers, ascii version. We only have one
339 * driver, which relays to WineD3D. If we were sufficiently cool,
340 * we could offer various interfaces, which use a different default surface
341 * implementation, but I think it's better to offer this choice in
342 * winecfg, because some apps use the default driver, so we would need
343 * a winecfg option anyway, and there shouldn't be 2 ways to set one setting
346 * Callback: Callback function from the app
347 * Context: Argument to the call back.
351 * E_INVALIDARG if the Callback caused a page fault
354 ***********************************************************************/
355 HRESULT WINAPI
DirectDrawEnumerateA(LPDDENUMCALLBACKA callback
, void *context
)
357 struct callback_info info
;
359 TRACE("callback %p, context %p.\n", callback
, context
);
361 info
.callback
= callback
;
362 info
.context
= context
;
363 return DirectDrawEnumerateExA(enum_callback
, &info
, 0x0);
366 /***********************************************************************
367 * DirectDrawEnumerateExA (DDRAW.@)
369 * Enumerates DirectDraw7 drivers, ascii version. See
370 * the comments above DirectDrawEnumerateA for more details.
372 * The Flag member is not supported right now.
374 ***********************************************************************/
375 HRESULT WINAPI
DirectDrawEnumerateExA(LPDDENUMCALLBACKEXA callback
, void *context
, DWORD flags
)
377 struct wined3d
*wined3d
;
379 TRACE("callback %p, context %p, flags %#x.\n", callback
, context
, flags
);
381 if (flags
& ~(DDENUM_ATTACHEDSECONDARYDEVICES
|
382 DDENUM_DETACHEDSECONDARYDEVICES
|
383 DDENUM_NONDISPLAYDEVICES
))
384 return DDERR_INVALIDPARAMS
;
387 FIXME("flags 0x%08x not handled\n", flags
);
389 TRACE("Enumerating ddraw interfaces\n");
390 wined3d
= wined3d_create(7, WINED3D_LEGACY_DEPTH_BIAS
);
394 /* QuickTime expects the description "DirectDraw HAL" */
395 static CHAR driver_desc
[] = "DirectDraw HAL",
396 driver_name
[] = "display";
397 struct wined3d_adapter_identifier adapter_id
;
402 /* The Battle.net System Checker expects both a NULL device and a GUID-based device */
403 TRACE("Default interface: DirectDraw HAL\n");
404 cont_enum
= callback(NULL
, driver_desc
, driver_name
, context
, 0);
405 for (adapter
= 0; SUCCEEDED(hr
) && cont_enum
; adapter
++)
407 char DriverName
[512] = "";
409 /* The Battle.net System Checker expects the GetAdapterIdentifier DeviceName to match the
410 * Driver Name, so obtain the DeviceName and GUID from D3D. */
411 memset(&adapter_id
, 0x0, sizeof(adapter_id
));
412 adapter_id
.device_name
= DriverName
;
413 adapter_id
.device_name_size
= sizeof(DriverName
);
414 wined3d_mutex_lock();
415 hr
= wined3d_get_adapter_identifier(wined3d
, adapter
, 0x0, &adapter_id
);
416 wined3d_mutex_unlock();
419 TRACE("Interface %d: %s\n", adapter
, wine_dbgstr_guid(&adapter_id
.device_identifier
));
420 cont_enum
= callback(&adapter_id
.device_identifier
, driver_desc
,
421 adapter_id
.device_name
, context
, 0);
427 wined3d_decref(wined3d
);
428 return DDERR_INVALIDPARAMS
;
432 wined3d_decref(wined3d
);
433 TRACE("End of enumeration\n");
437 /***********************************************************************
438 * DirectDrawEnumerateW (DDRAW.@)
440 * Enumerates legacy drivers, unicode version.
441 * This function is not implemented on Windows.
443 ***********************************************************************/
444 HRESULT WINAPI
DirectDrawEnumerateW(LPDDENUMCALLBACKW callback
, void *context
)
446 TRACE("callback %p, context %p.\n", callback
, context
);
449 return DDERR_INVALIDPARAMS
;
451 return DDERR_UNSUPPORTED
;
454 /***********************************************************************
455 * DirectDrawEnumerateExW (DDRAW.@)
457 * Enumerates DirectDraw7 drivers, unicode version.
458 * This function is not implemented on Windows.
460 ***********************************************************************/
461 HRESULT WINAPI
DirectDrawEnumerateExW(LPDDENUMCALLBACKEXW callback
, void *context
, DWORD flags
)
463 TRACE("callback %p, context %p, flags %#x.\n", callback
, context
, flags
);
465 return DDERR_UNSUPPORTED
;
468 /***********************************************************************
469 * Classfactory implementation.
470 ***********************************************************************/
472 /***********************************************************************
473 * CF_CreateDirectDraw
475 * DDraw creation function for the class factory
478 * UnkOuter: Set to NULL
479 * iid: ID of the wanted interface
480 * obj: Address to pass the interface pointer back
483 * DD_OK / DDERR*, see DDRAW_Create
485 ***********************************************************************/
487 CF_CreateDirectDraw(IUnknown
* UnkOuter
, REFIID iid
,
492 TRACE("outer_unknown %p, riid %s, object %p.\n", UnkOuter
, debugstr_guid(iid
), obj
);
494 wined3d_mutex_lock();
495 hr
= DDRAW_Create(NULL
, obj
, UnkOuter
, iid
);
496 wined3d_mutex_unlock();
501 /***********************************************************************
502 * CF_CreateDirectDraw
504 * Clipper creation function for the class factory
507 * UnkOuter: Set to NULL
508 * iid: ID of the wanted interface
509 * obj: Address to pass the interface pointer back
512 * DD_OK / DDERR*, see DDRAW_Create
514 ***********************************************************************/
516 CF_CreateDirectDrawClipper(IUnknown
* UnkOuter
, REFIID riid
,
520 IDirectDrawClipper
*Clip
;
522 TRACE("outer_unknown %p, riid %s, object %p.\n", UnkOuter
, debugstr_guid(riid
), obj
);
524 wined3d_mutex_lock();
525 hr
= DirectDrawCreateClipper(0, &Clip
, UnkOuter
);
528 wined3d_mutex_unlock();
532 hr
= IDirectDrawClipper_QueryInterface(Clip
, riid
, obj
);
533 IDirectDrawClipper_Release(Clip
);
535 wined3d_mutex_unlock();
540 static const struct object_creation_info object_creation
[] =
542 { &CLSID_DirectDraw
, CF_CreateDirectDraw
},
543 { &CLSID_DirectDraw7
, CF_CreateDirectDraw
},
544 { &CLSID_DirectDrawClipper
, CF_CreateDirectDrawClipper
}
547 struct ddraw_class_factory
549 IClassFactory IClassFactory_iface
;
552 HRESULT (*pfnCreateInstance
)(IUnknown
*pUnkOuter
, REFIID iid
, LPVOID
*ppObj
);
555 static inline struct ddraw_class_factory
*impl_from_IClassFactory(IClassFactory
*iface
)
557 return CONTAINING_RECORD(iface
, struct ddraw_class_factory
, IClassFactory_iface
);
560 /*******************************************************************************
561 * IDirectDrawClassFactory::QueryInterface
563 * QueryInterface for the class factory
566 * riid Reference to identifier of queried interface
567 * ppv Address to return the interface pointer at
571 * Failure: E_NOINTERFACE
573 *******************************************************************************/
574 static HRESULT WINAPI
ddraw_class_factory_QueryInterface(IClassFactory
*iface
, REFIID riid
, void **out
)
576 TRACE("iface %p, riid %s, out %p.\n", iface
, debugstr_guid(riid
), out
);
578 if (IsEqualGUID(riid
, &IID_IUnknown
)
579 || IsEqualGUID(riid
, &IID_IClassFactory
))
581 IClassFactory_AddRef(iface
);
586 WARN("%s not implemented, returning E_NOINTERFACE.\n", debugstr_guid(riid
));
588 return E_NOINTERFACE
;
591 /*******************************************************************************
592 * IDirectDrawClassFactory::AddRef
594 * AddRef for the class factory
599 *******************************************************************************/
600 static ULONG WINAPI
ddraw_class_factory_AddRef(IClassFactory
*iface
)
602 struct ddraw_class_factory
*factory
= impl_from_IClassFactory(iface
);
603 ULONG ref
= InterlockedIncrement(&factory
->ref
);
605 TRACE("%p increasing refcount to %u.\n", factory
, ref
);
610 /*******************************************************************************
611 * IDirectDrawClassFactory::Release
613 * Release for the class factory. If the refcount falls to 0, the object
619 *******************************************************************************/
620 static ULONG WINAPI
ddraw_class_factory_Release(IClassFactory
*iface
)
622 struct ddraw_class_factory
*factory
= impl_from_IClassFactory(iface
);
623 ULONG ref
= InterlockedDecrement(&factory
->ref
);
625 TRACE("%p decreasing refcount to %u.\n", factory
, ref
);
628 HeapFree(GetProcessHeap(), 0, factory
);
634 /*******************************************************************************
635 * IDirectDrawClassFactory::CreateInstance
637 * What is this? Seems to create DirectDraw objects...
640 * The usual things???
645 *******************************************************************************/
646 static HRESULT WINAPI
ddraw_class_factory_CreateInstance(IClassFactory
*iface
,
647 IUnknown
*outer_unknown
, REFIID riid
, void **out
)
649 struct ddraw_class_factory
*factory
= impl_from_IClassFactory(iface
);
651 TRACE("iface %p, outer_unknown %p, riid %s, out %p.\n",
652 iface
, outer_unknown
, debugstr_guid(riid
), out
);
654 return factory
->pfnCreateInstance(outer_unknown
, riid
, out
);
657 /*******************************************************************************
658 * IDirectDrawClassFactory::LockServer
666 * S_OK, because it's a stub
668 *******************************************************************************/
669 static HRESULT WINAPI
ddraw_class_factory_LockServer(IClassFactory
*iface
, BOOL dolock
)
671 FIXME("iface %p, dolock %#x stub!\n", iface
, dolock
);
676 /*******************************************************************************
677 * The class factory VTable
678 *******************************************************************************/
679 static const IClassFactoryVtbl IClassFactory_Vtbl
=
681 ddraw_class_factory_QueryInterface
,
682 ddraw_class_factory_AddRef
,
683 ddraw_class_factory_Release
,
684 ddraw_class_factory_CreateInstance
,
685 ddraw_class_factory_LockServer
688 /*******************************************************************************
689 * DllGetClassObject [DDRAW.@]
690 * Retrieves class object from a DLL object
693 * Docs say returns STDAPI
696 * rclsid [I] CLSID for the class object
697 * riid [I] Reference to identifier of interface for class object
698 * ppv [O] Address of variable to receive interface pointer for riid
702 * Failure: CLASS_E_CLASSNOTAVAILABLE, E_OUTOFMEMORY, E_INVALIDARG,
705 HRESULT WINAPI
DllGetClassObject(REFCLSID rclsid
, REFIID riid
, LPVOID
*ppv
)
707 struct ddraw_class_factory
*factory
;
710 TRACE("rclsid %s, riid %s, object %p.\n",
711 debugstr_guid(rclsid
), debugstr_guid(riid
), ppv
);
713 if (!IsEqualGUID(&IID_IClassFactory
, riid
)
714 && !IsEqualGUID(&IID_IUnknown
, riid
))
715 return E_NOINTERFACE
;
717 for (i
=0; i
< sizeof(object_creation
)/sizeof(object_creation
[0]); i
++)
719 if (IsEqualGUID(object_creation
[i
].clsid
, rclsid
))
723 if (i
== sizeof(object_creation
)/sizeof(object_creation
[0]))
725 FIXME("%s: no class found.\n", debugstr_guid(rclsid
));
726 return CLASS_E_CLASSNOTAVAILABLE
;
729 factory
= HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY
, sizeof(*factory
));
730 if (factory
== NULL
) return E_OUTOFMEMORY
;
732 factory
->IClassFactory_iface
.lpVtbl
= &IClassFactory_Vtbl
;
735 factory
->pfnCreateInstance
= object_creation
[i
].pfnCreateInstance
;
742 /*******************************************************************************
743 * DllCanUnloadNow [DDRAW.@] Determines whether the DLL is in use.
749 HRESULT WINAPI
DllCanUnloadNow(void)
757 /***********************************************************************
758 * DllRegisterServer (DDRAW.@)
760 HRESULT WINAPI
DllRegisterServer(void)
762 return __wine_register_resources( instance
);
765 /***********************************************************************
766 * DllUnregisterServer (DDRAW.@)
768 HRESULT WINAPI
DllUnregisterServer(void)
770 return __wine_unregister_resources( instance
);
773 /*******************************************************************************
776 * Callback function for the EnumSurfaces call in DllMain.
777 * Dumps some surface info and releases the surface
780 * surf: The enumerated surface
781 * desc: it's description
782 * context: Pointer to the ddraw impl
786 *******************************************************************************/
787 static HRESULT WINAPI
788 DestroyCallback(IDirectDrawSurface7
*surf
,
789 DDSURFACEDESC2
*desc
,
792 struct ddraw_surface
*Impl
= impl_from_IDirectDrawSurface7(surf
);
793 ULONG ref7
, ref4
, ref3
, ref2
, ref1
, gamma_count
, iface_count
;
795 ref7
= IDirectDrawSurface7_Release(surf
); /* For the EnumSurfaces */
800 gamma_count
= Impl
->gamma_count
;
802 WARN("Surface %p has an reference counts of 7: %u 4: %u 3: %u 2: %u 1: %u gamma: %u\n",
803 Impl
, ref7
, ref4
, ref3
, ref2
, ref1
, gamma_count
);
805 /* Skip surfaces which are attached somewhere or which are
806 * part of a complex compound. They will get released when destroying
809 if( (!Impl
->is_complex_root
) || (Impl
->first_attached
!= Impl
) )
812 /* Destroy the surface */
813 iface_count
= ddraw_surface_release_iface(Impl
);
814 while (iface_count
) iface_count
= ddraw_surface_release_iface(Impl
);
819 /***********************************************************************
822 * Reads a config key from the registry. Taken from WineD3D
824 ***********************************************************************/
825 static inline DWORD
get_config_key(HKEY defkey
, HKEY appkey
, const char* name
, char* buffer
, DWORD size
)
827 if (0 != appkey
&& !RegQueryValueExA( appkey
, name
, 0, NULL
, (LPBYTE
) buffer
, &size
)) return 0;
828 if (0 != defkey
&& !RegQueryValueExA( defkey
, name
, 0, NULL
, (LPBYTE
) buffer
, &size
)) return 0;
829 return ERROR_FILE_NOT_FOUND
;
832 /***********************************************************************
835 * Could be used to register DirectDraw drivers, if we have more than
836 * one. Also used to destroy any objects left at unload if the
837 * app didn't release them properly(Gothic 2, Diablo 2, Moto racer, ...)
839 ***********************************************************************/
841 DllMain(HINSTANCE hInstDLL
,
845 TRACE("(%p,%x,%p)\n", hInstDLL
, Reason
, lpv
);
846 if (Reason
== DLL_PROCESS_ATTACH
)
848 static HMODULE ddraw_self
;
849 char buffer
[MAX_PATH
+10];
850 DWORD size
= sizeof(buffer
);
856 /* Register the window class. This is used to create a hidden window
857 * for D3D rendering, if the application didn't pass one. It can also
858 * be used for creating a device window from SetCooperativeLevel(). */
859 wc
.style
= CS_HREDRAW
| CS_VREDRAW
;
860 wc
.lpfnWndProc
= DefWindowProcA
;
863 wc
.hInstance
= hInstDLL
;
866 wc
.hbrBackground
= GetStockObject(BLACK_BRUSH
);
867 wc
.lpszMenuName
= NULL
;
868 wc
.lpszClassName
= DDRAW_WINDOW_CLASS_NAME
;
869 if (!RegisterClassA(&wc
))
871 ERR("Failed to register ddraw window class, last error %#x.\n", GetLastError());
875 /* @@ Wine registry key: HKCU\Software\Wine\Direct3D */
876 if ( RegOpenKeyA( HKEY_CURRENT_USER
, "Software\\Wine\\Direct3D", &hkey
) ) hkey
= 0;
878 len
= GetModuleFileNameA( 0, buffer
, MAX_PATH
);
879 if (len
&& len
< MAX_PATH
)
882 /* @@ Wine registry key: HKCU\Software\Wine\AppDefaults\app.exe\Direct3D */
883 if (!RegOpenKeyA( HKEY_CURRENT_USER
, "Software\\Wine\\AppDefaults", &tmpkey
))
885 char *p
, *appname
= buffer
;
886 if ((p
= strrchr( appname
, '/' ))) appname
= p
+ 1;
887 if ((p
= strrchr( appname
, '\\' ))) appname
= p
+ 1;
888 strcat( appname
, "\\Direct3D" );
889 TRACE("appname = [%s]\n", appname
);
890 if (RegOpenKeyA( tmpkey
, appname
, &appkey
)) appkey
= 0;
891 RegCloseKey( tmpkey
);
895 if ( 0 != hkey
|| 0 != appkey
)
897 if ( !get_config_key( hkey
, appkey
, "DirectDrawRenderer", buffer
, size
) )
899 if (!strcmp(buffer
,"gdi"))
901 TRACE("Defaulting to GDI surfaces\n");
902 DefaultSurfaceType
= WINED3D_SURFACE_TYPE_GDI
;
904 else if (!strcmp(buffer
,"opengl"))
906 TRACE("Defaulting to opengl surfaces\n");
907 DefaultSurfaceType
= WINED3D_SURFACE_TYPE_OPENGL
;
911 ERR("Unknown default surface type. Supported are:\n gdi, opengl\n");
916 /* On Windows one can force the refresh rate that DirectDraw uses by
917 * setting an override value in dxdiag. This is documented in KB315614
918 * (main article), KB230002, and KB217348. By comparing registry dumps
919 * before and after setting the override, we see that the override value
920 * is stored in HKLM\Software\Microsoft\DirectDraw\ForceRefreshRate as a
921 * DWORD that represents the refresh rate to force. We use this
922 * registry entry to modify the behavior of SetDisplayMode so that Wine
923 * users can override the refresh rate in a Windows-compatible way.
925 * dxdiag will not accept a refresh rate lower than 40 or higher than
926 * 120 so this value should be within that range. It is, of course,
927 * possible for a user to set the registry entry value directly so that
928 * assumption might not hold.
930 * There is no current mechanism for setting this value through the Wine
931 * GUI. It would be most appropriate to set this value through a dxdiag
932 * clone, but it may be sufficient to use winecfg.
934 * TODO: Create a mechanism for setting this value through the Wine GUI.
936 if ( !RegOpenKeyA( HKEY_LOCAL_MACHINE
, "Software\\Microsoft\\DirectDraw", &hkey
) )
940 if (!RegQueryValueExA( hkey
, "ForceRefreshRate", NULL
, &type
, (LPBYTE
)&data
, &size
) && type
== REG_DWORD
)
942 TRACE("ForceRefreshRate set; overriding refresh rate to %d Hz\n", data
);
943 force_refresh_rate
= data
;
948 /* Prevent the ddraw module from being unloaded. When switching to
949 * exclusive mode, we replace the window proc of the ddraw window. If
950 * an application would unload ddraw from the WM_DESTROY handler for
951 * that window, it would return to unmapped memory and die. Apparently
952 * this is supposed to work on Windows. We should probably use
953 * GET_MODULE_HANDLE_EX_FLAG_PIN for this, but that's not currently
955 if (!GetModuleHandleExW(GET_MODULE_HANDLE_EX_FLAG_FROM_ADDRESS
, (const WCHAR
*)&ddraw_self
, &ddraw_self
))
956 ERR("Failed to get own module handle.\n");
959 DisableThreadLibraryCalls(hInstDLL
);
961 else if (Reason
== DLL_PROCESS_DETACH
)
963 if(!list_empty(&global_ddraw_list
))
965 struct list
*entry
, *entry2
;
966 WARN("There are still existing DirectDraw interfaces. Wine bug or buggy application?\n");
968 /* We remove elements from this loop */
969 LIST_FOR_EACH_SAFE(entry
, entry2
, &global_ddraw_list
)
971 struct ddraw
*ddraw
= LIST_ENTRY(entry
, struct ddraw
, ddraw_list_entry
);
976 WARN("DDraw %p has a refcount of %d\n", ddraw
, ddraw
->ref7
+ ddraw
->ref4
+ ddraw
->ref3
+ ddraw
->ref2
+ ddraw
->ref1
);
978 /* Add references to each interface to avoid freeing them unexpectedly */
979 IDirectDraw_AddRef(&ddraw
->IDirectDraw_iface
);
980 IDirectDraw2_AddRef(&ddraw
->IDirectDraw2_iface
);
981 IDirectDraw4_AddRef(&ddraw
->IDirectDraw4_iface
);
982 IDirectDraw7_AddRef(&ddraw
->IDirectDraw7_iface
);
984 /* Does a D3D device exist? Destroy it
985 * TODO: Destroy all Vertex buffers, Lights, Materials
986 * and execute buffers too
990 WARN("DDraw %p has d3ddevice %p attached\n", ddraw
, ddraw
->d3ddevice
);
991 while(IDirect3DDevice7_Release(&ddraw
->d3ddevice
->IDirect3DDevice7_iface
));
994 /* Destroy the swapchain after any 3D device. The 3D device
995 * cleanup code needs a swapchain. Specifically, it tries to
996 * set the current render target to the front buffer. */
997 if (ddraw
->wined3d_swapchain
)
998 ddraw_destroy_swapchain(ddraw
);
1000 /* Try to release the objects
1001 * Do an EnumSurfaces to find any hanging surfaces
1003 memset(&desc
, 0, sizeof(desc
));
1004 desc
.dwSize
= sizeof(desc
);
1005 for(i
= 0; i
<= 1; i
++)
1007 hr
= IDirectDraw7_EnumSurfaces(&ddraw
->IDirectDraw7_iface
, DDENUMSURFACES_ALL
,
1008 &desc
, ddraw
, DestroyCallback
);
1010 ERR("(%p) EnumSurfaces failed, prepare for trouble\n", ddraw
);
1013 if (!list_empty(&ddraw
->surface_list
))
1014 ERR("DDraw %p still has surfaces attached.\n", ddraw
);
1016 /* Release all hanging references to destroy the objects. This
1017 * restores the screen mode too
1019 while(IDirectDraw_Release(&ddraw
->IDirectDraw_iface
));
1020 while(IDirectDraw2_Release(&ddraw
->IDirectDraw2_iface
));
1021 while(IDirectDraw4_Release(&ddraw
->IDirectDraw4_iface
));
1022 while(IDirectDraw7_Release(&ddraw
->IDirectDraw7_iface
));
1026 /* Unregister the window class. */
1027 UnregisterClassA(DDRAW_WINDOW_CLASS_NAME
, hInstDLL
);