comctl32/tests: Fix wrong comment-headline in toolbar.c.
[wine] / dlls / ddraw / parent.c
1 /*
2  * IParent implementation
3  *
4  * Copyright (c) 2006 Stefan Dösinger
5  *
6  * This library is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2.1 of the License, or (at your option) any later version.
10  *
11  * This library is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with this library; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
19  *
20  * A universal parent interface for everything in WineD3D that doesn't have
21  * a DDraw counterpart
22  */
23
24 #include "config.h"
25 #include "wine/port.h"
26 #include "wine/debug.h"
27
28 #include <assert.h>
29 #include <stdarg.h>
30 #include <string.h>
31 #include <stdlib.h>
32
33 #define COBJMACROS
34
35 #include "windef.h"
36 #include "winbase.h"
37 #include "winerror.h"
38 #include "wingdi.h"
39 #include "wine/exception.h"
40
41 #include "ddraw.h"
42 #include "d3d.h"
43
44 #include "ddraw_private.h"
45
46 WINE_DEFAULT_DEBUG_CHANNEL(ddraw);
47
48 const GUID IID_IParent = {0xc20e4c88, 0x74e7, 0x4940, {0xba, 0x9f, 0x2e, 0x32, 0x3f, 0x9d, 0xc9, 0x81}};
49
50 /*****************************************************************************
51  * IUnknown methods
52  *****************************************************************************/
53
54 /*****************************************************************************
55  * IParent::Queryinterface
56  *
57  * It can't query any interfaces, and it's not used for anything. So
58  * it just returns E_NOINTERFACE
59  *
60  * Params:
61  *  riid: guid of queried interface
62  *  obj: returns a pointer to the interface
63  *
64  * Return values
65  *  This implementation always returns E_NOINTERFACE and NULL
66  *
67  *****************************************************************************/
68 static HRESULT WINAPI
69 IParentImpl_QueryInterface(IParent *iface,
70                            REFIID riid,
71                            void **obj)
72 {
73     ICOM_THIS_FROM(IParentImpl, IParent, iface);
74     TRACE("(%p)->(%s,%p)\n", This, debugstr_guid(riid), obj);
75
76     *obj = NULL;
77     if ( IsEqualGUID( &IID_IUnknown, riid ) ||
78          IsEqualGUID( &IID_IParent, riid ) )
79     {
80         *obj = ICOM_INTERFACE(This, IParent);
81         IParent_AddRef(ICOM_INTERFACE(This, IParent));
82         return DD_OK;
83     }
84     return E_NOINTERFACE;
85 }
86
87 /*****************************************************************************
88  * IParent::AddRef
89  *
90  * Increases the refcount
91  *
92  * Params:
93  *
94  * Return values
95  *  The new refcount
96  *
97  *****************************************************************************/
98 static ULONG WINAPI
99 IParentImpl_AddRef(IParent *iface)
100 {
101     ICOM_THIS_FROM(IParentImpl, IParent, iface);
102     ULONG ref = InterlockedIncrement(&This->ref);
103
104     TRACE("(%p) : AddRef from %d\n", This, ref - 1);
105
106     return ref;
107 }
108
109
110 /*****************************************************************************
111  * IParent::Release
112  *
113  * Releases the refcount, and destroys the object if the refcount falls to 0
114  * Also releases the child object, if destroyed. That's almost the whole sense
115  * of this interface.
116  *
117  * Params:
118  *
119  * Return values
120  *  The new refcount
121  *
122  *****************************************************************************/
123 static ULONG WINAPI 
124 IParentImpl_Release(IParent *iface)
125 {
126     ICOM_THIS_FROM(IParentImpl, IParent, iface);
127     ULONG ref = InterlockedDecrement(&This->ref);
128
129     TRACE("(%p) : ReleaseRef to %d\n", This, ref);
130
131     if (ref == 0)
132     {
133         TRACE("(%p) Releasing child at %p\n", This, This->child);
134         if(This->child)
135             IUnknown_Release(This->child);
136         HeapFree(GetProcessHeap(), 0, This);
137         TRACE("Released\n");
138     }
139     return ref;
140 }
141
142 /*****************************************************************************
143  * The VTable
144  *****************************************************************************/
145 const IParentVtbl IParent_Vtbl =
146 {
147      IParentImpl_QueryInterface,
148      IParentImpl_AddRef,
149      IParentImpl_Release,
150 };