| /* |
| * Copyright (C) 1998-1999 François Gouget |
| * |
| * This library is free software; you can redistribute it and/or |
| * modify it under the terms of the GNU Lesser General Public |
| * License as published by the Free Software Foundation; either |
| * version 2.1 of the License, or (at your option) any later version. |
| * |
| * This library is distributed in the hope that it will be useful, |
| * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
| * Lesser General Public License for more details. |
| * |
| * You should have received a copy of the GNU Lesser General Public |
| * License along with this library; if not, write to the Free Software |
| * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
| */ |
| |
| #include "rpc.h" |
| #include "rpcndr.h" |
| |
| #ifndef _OBJBASE_H_ |
| #define _OBJBASE_H_ |
| |
| /***************************************************************************** |
| * define ICOM_MSVTABLE_COMPAT |
| * to implement the microsoft com vtable compatibility workaround for g++. |
| * |
| * NOTE: Turning this option on will produce a winelib that is incompatible |
| * with the binary emulator. |
| * |
| * If the compiler supports the com_interface attribute, leave this off, and |
| * define the ICOM_USE_COM_INTERFACE_ATTRIBUTE macro below. This may also |
| * require the addition of the -vtable-thunks option for g++. |
| * |
| * If you aren't interested in Winelib C++ compatibility at all, leave both |
| * options off. |
| * |
| * The preferable method for using ICOM_USE_COM_INTERFACE_ATTRIBUTE macro |
| * would be to define it only for your Winelib application. This allows you |
| * to have both binary and Winelib compatibility for C and C++ at the same |
| * time :) |
| */ |
| /* #define ICOM_MSVTABLE_COMPAT 1 */ |
| /* #define ICOM_USE_COM_INTERFACE_ATTRIBUTE 1 */ |
| |
| #include "objidl.h" |
| |
| #ifndef RC_INVOKED |
| /* For compatibility only, at least for now */ |
| #include <stdlib.h> |
| #endif |
| |
| #ifndef INITGUID |
| #include "cguid.h" |
| #endif |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif |
| |
| #ifndef NONAMELESSSTRUCT |
| #define LISet32(li, v) ((li).HighPart = (v) < 0 ? -1 : 0, (li).LowPart = (v)) |
| #define ULISet32(li, v) ((li).HighPart = 0, (li).LowPart = (v)) |
| #else |
| #define LISet32(li, v) ((li).s.HighPart = (v) < 0 ? -1 : 0, (li).s.LowPart = (v)) |
| #define ULISet32(li, v) ((li).s.HighPart = 0, (li).s.LowPart = (v)) |
| #endif |
| |
| /***************************************************************************** |
| * Standard API |
| */ |
| DWORD WINAPI CoBuildVersion(void); |
| |
| typedef enum tagCOINIT |
| { |
| COINIT_APARTMENTTHREADED = 0x2, /* Apartment model */ |
| COINIT_MULTITHREADED = 0x0, /* OLE calls objects on any thread */ |
| COINIT_DISABLE_OLE1DDE = 0x4, /* Don't use DDE for Ole1 support */ |
| COINIT_SPEED_OVER_MEMORY = 0x8 /* Trade memory for speed */ |
| } COINIT; |
| |
| HRESULT WINAPI CoInitialize(LPVOID lpReserved); |
| HRESULT WINAPI CoInitializeEx(LPVOID lpReserved, DWORD dwCoInit); |
| void WINAPI CoUninitialize(void); |
| DWORD WINAPI CoGetCurrentProcess(void); |
| |
| HINSTANCE WINAPI CoLoadLibrary(LPOLESTR lpszLibName, BOOL bAutoFree); |
| void WINAPI CoFreeAllLibraries(void); |
| void WINAPI CoFreeLibrary(HINSTANCE hLibrary); |
| void WINAPI CoFreeUnusedLibraries(void); |
| |
| HRESULT WINAPI CoCreateInstance(REFCLSID rclsid, LPUNKNOWN pUnkOuter, DWORD dwClsContext, REFIID iid, LPVOID *ppv); |
| HRESULT WINAPI CoCreateInstanceEx(REFCLSID rclsid, |
| LPUNKNOWN pUnkOuter, |
| DWORD dwClsContext, |
| COSERVERINFO* pServerInfo, |
| ULONG cmq, |
| MULTI_QI* pResults); |
| |
| HRESULT WINAPI CoGetInstanceFromFile(COSERVERINFO* pServerInfo, CLSID* pClsid, IUnknown* punkOuter, DWORD dwClsCtx, DWORD grfMode, OLECHAR* pwszName, DWORD dwCount, MULTI_QI* pResults); |
| HRESULT WINAPI CoGetInstanceFromIStorage(COSERVERINFO* pServerInfo, CLSID* pClsid, IUnknown* punkOuter, DWORD dwClsCtx, IStorage* pstg, DWORD dwCount, MULTI_QI* pResults); |
| |
| HRESULT WINAPI CoGetMalloc(DWORD dwMemContext, LPMALLOC* lpMalloc); |
| LPVOID WINAPI CoTaskMemAlloc(ULONG size); |
| void WINAPI CoTaskMemFree(LPVOID ptr); |
| LPVOID WINAPI CoTaskMemRealloc(LPVOID ptr, ULONG size); |
| |
| HRESULT WINAPI CoRegisterMallocSpy(LPMALLOCSPY pMallocSpy); |
| HRESULT WINAPI CoRevokeMallocSpy(void); |
| |
| /* class registration flags; passed to CoRegisterClassObject */ |
| typedef enum tagREGCLS |
| { |
| REGCLS_SINGLEUSE = 0, |
| REGCLS_MULTIPLEUSE = 1, |
| REGCLS_MULTI_SEPARATE = 2, |
| REGCLS_SUSPENDED = 4 |
| } REGCLS; |
| |
| HRESULT WINAPI CoGetClassObject(REFCLSID rclsid, DWORD dwClsContext, COSERVERINFO *pServerInfo, REFIID iid, LPVOID *ppv); |
| HRESULT WINAPI CoRegisterClassObject(REFCLSID rclsid,LPUNKNOWN pUnk,DWORD dwClsContext,DWORD flags,LPDWORD lpdwRegister); |
| HRESULT WINAPI CoRevokeClassObject(DWORD dwRegister); |
| HRESULT WINAPI CoGetPSClsid(REFIID riid,CLSID *pclsid); |
| HRESULT WINAPI CoRegisterPSClsid(REFIID riid, REFCLSID rclsid); |
| HRESULT WINAPI CoSuspendClassObjects(void); |
| HRESULT WINAPI CoResumeClassObjects(void); |
| ULONG WINAPI CoAddRefServerProcess(void); |
| HRESULT WINAPI CoReleaseServerProcess(void); |
| |
| /* marshalling */ |
| HRESULT WINAPI CoCreateFreeThreadedMarshaler(LPUNKNOWN punkOuter, LPUNKNOWN* ppunkMarshal); |
| HRESULT WINAPI CoGetInterfaceAndReleaseStream(LPSTREAM pStm, REFIID iid, LPVOID* ppv); |
| HRESULT WINAPI CoGetMarshalSizeMax(ULONG* pulSize, REFIID riid, LPUNKNOWN pUnk, DWORD dwDestContext, LPVOID pvDestContext, DWORD mshlflags); |
| HRESULT WINAPI CoGetStandardMarshal(REFIID riid, LPUNKNOWN pUnk, DWORD dwDestContext, LPVOID pvDestContext, DWORD mshlflags, LPMARSHAL* ppMarshal); |
| HRESULT WINAPI CoMarshalHresult(LPSTREAM pstm, HRESULT hresult); |
| HRESULT WINAPI CoMarshalInterface(LPSTREAM pStm, REFIID riid, LPUNKNOWN pUnk, DWORD dwDestContext, LPVOID pvDestContext, DWORD mshlflags); |
| HRESULT WINAPI CoMarshalInterThreadInterfaceInStream(REFIID riid, LPUNKNOWN pUnk, LPSTREAM* ppStm); |
| HRESULT WINAPI CoReleaseMarshalData(LPSTREAM pStm); |
| HRESULT WINAPI CoUnmarshalHresult(LPSTREAM pstm, HRESULT* phresult); |
| HRESULT WINAPI CoUnmarshalInterface(LPSTREAM pStm, REFIID riid, LPVOID* ppv); |
| HRESULT WINAPI CoLockObjectExternal(LPUNKNOWN pUnk, BOOL fLock, BOOL fLastUnlockReleases); |
| BOOL WINAPI CoIsHandlerConnected(LPUNKNOWN pUnk); |
| |
| /* security */ |
| HRESULT WINAPI CoInitializeSecurity(PSECURITY_DESCRIPTOR pSecDesc, LONG cAuthSvc, SOLE_AUTHENTICATION_SERVICE* asAuthSvc, void* pReserved1, DWORD dwAuthnLevel, DWORD dwImpLevel, void* pReserved2, DWORD dwCapabilities, void* pReserved3); |
| HRESULT WINAPI CoGetCallContext(REFIID riid, void** ppInterface); |
| HRESULT WINAPI CoQueryAuthenticationServices(DWORD* pcAuthSvc, SOLE_AUTHENTICATION_SERVICE** asAuthSvc); |
| |
| HRESULT WINAPI CoQueryProxyBlanket(IUnknown* pProxy, DWORD* pwAuthnSvc, DWORD* pAuthzSvc, OLECHAR** pServerPrincName, DWORD* pAuthnLevel, DWORD* pImpLevel, RPC_AUTH_IDENTITY_HANDLE* pAuthInfo, DWORD* pCapabilites); |
| HRESULT WINAPI CoSetProxyBlanket(IUnknown* pProxy, DWORD dwAuthnSvc, DWORD dwAuthzSvc, OLECHAR* pServerPrincName, DWORD dwAuthnLevel, DWORD dwImpLevel, RPC_AUTH_IDENTITY_HANDLE pAuthInfo, DWORD dwCapabilities); |
| HRESULT WINAPI CoCopyProxy(IUnknown* pProxy, IUnknown** ppCopy); |
| |
| HRESULT WINAPI CoImpersonateClient(void); |
| HRESULT WINAPI CoQueryClientBlanket(DWORD* pAuthnSvc, DWORD* pAuthzSvc, OLECHAR16** pServerPrincName, DWORD* pAuthnLevel, DWORD* pImpLevel, RPC_AUTHZ_HANDLE* pPrivs, DWORD* pCapabilities); |
| HRESULT WINAPI CoRevertToSelf(void); |
| |
| /* misc */ |
| HRESULT WINAPI CoGetTreatAsClass(REFCLSID clsidOld, LPCLSID pClsidNew); |
| HRESULT WINAPI CoTreatAsClass(REFCLSID clsidOld, REFCLSID clsidNew); |
| |
| HRESULT WINAPI CoCreateGuid(GUID* pguid); |
| BOOL WINAPI CoIsOle1Class(REFCLSID rclsid); |
| |
| BOOL WINAPI CoDosDateTimeToFileTime(WORD nDosDate, WORD nDosTime, FILETIME* lpFileTime); |
| BOOL WINAPI CoFileTimeToDosDateTime(FILETIME* lpFileTime, WORD* lpDosDate, WORD* lpDosTime); |
| HRESULT WINAPI CoFileTimeNow(FILETIME* lpFileTime); |
| |
| /***************************************************************************** |
| * GUID API |
| */ |
| HRESULT WINAPI StringFromCLSID16(REFCLSID id, LPOLESTR16*); |
| HRESULT WINAPI StringFromCLSID(REFCLSID id, LPOLESTR*); |
| |
| HRESULT WINAPI CLSIDFromString16(LPCOLESTR16, CLSID *); |
| HRESULT WINAPI CLSIDFromString(LPCOLESTR, CLSID *); |
| |
| HRESULT WINAPI CLSIDFromProgID16(LPCOLESTR16 progid, LPCLSID riid); |
| HRESULT WINAPI CLSIDFromProgID(LPCOLESTR progid, LPCLSID riid); |
| |
| HRESULT WINAPI ProgIDFromCLSID(REFCLSID clsid, LPOLESTR *lplpszProgID); |
| |
| INT WINAPI StringFromGUID2(REFGUID id, LPOLESTR str, INT cmax); |
| |
| /***************************************************************************** |
| * COM Server dll - exports |
| */ |
| HRESULT WINAPI DllGetClassObject(REFCLSID rclsid, REFIID riid, LPVOID * ppv); |
| HRESULT WINAPI DllCanUnloadNow(void); |
| |
| /***************************************************************************** |
| * Data Object |
| */ |
| HRESULT WINAPI CreateDataAdviseHolder(LPDATAADVISEHOLDER* ppDAHolder); |
| HRESULT WINAPI CreateDataCache(LPUNKNOWN pUnkOuter, REFCLSID rclsid, REFIID iid, LPVOID* ppv); |
| |
| /***************************************************************************** |
| * Moniker API |
| */ |
| HRESULT WINAPI GetClassFile(LPCOLESTR filePathName,CLSID *pclsid); |
| |
| HRESULT WINAPI CreateBindCtx16(DWORD reserved, LPBC* ppbc); |
| HRESULT WINAPI CreateBindCtx(DWORD reserved, LPBC* ppbc); |
| |
| HRESULT WINAPI CreateFileMoniker16(LPCOLESTR16 lpszPathName, LPMONIKER* ppmk); |
| HRESULT WINAPI CreateFileMoniker(LPCOLESTR lpszPathName, LPMONIKER* ppmk); |
| |
| HRESULT WINAPI CreateItemMoniker16(LPCOLESTR16 lpszDelim, LPCOLESTR lpszItem, LPMONIKER* ppmk); |
| HRESULT WINAPI CreateItemMoniker(LPCOLESTR lpszDelim, LPCOLESTR lpszItem, LPMONIKER* ppmk); |
| |
| HRESULT WINAPI CreateAntiMoniker(LPMONIKER * ppmk); |
| |
| HRESULT WINAPI CreateGenericComposite(LPMONIKER pmkFirst, LPMONIKER pmkRest, LPMONIKER* ppmkComposite); |
| |
| HRESULT WINAPI BindMoniker(LPMONIKER pmk, DWORD grfOpt, REFIID iidResult, LPVOID* ppvResult); |
| |
| HRESULT WINAPI CreateClassMoniker(REFCLSID rclsid, LPMONIKER* ppmk); |
| |
| HRESULT WINAPI CreatePointerMoniker(LPUNKNOWN punk, LPMONIKER* ppmk); |
| |
| HRESULT WINAPI MonikerCommonPrefixWith(IMoniker* pmkThis,IMoniker* pmkOther,IMoniker** ppmkCommon); |
| |
| HRESULT WINAPI GetRunningObjectTable(DWORD reserved, LPRUNNINGOBJECTTABLE *pprot); |
| HRESULT WINAPI GetRunningObjectTable16(DWORD reserved, LPRUNNINGOBJECTTABLE *pprot); |
| |
| /***************************************************************************** |
| * Storage API |
| */ |
| #define STGM_DIRECT 0x00000000 |
| #define STGM_TRANSACTED 0x00010000 |
| #define STGM_SIMPLE 0x08000000 |
| #define STGM_READ 0x00000000 |
| #define STGM_WRITE 0x00000001 |
| #define STGM_READWRITE 0x00000002 |
| #define STGM_SHARE_DENY_NONE 0x00000040 |
| #define STGM_SHARE_DENY_READ 0x00000030 |
| #define STGM_SHARE_DENY_WRITE 0x00000020 |
| #define STGM_SHARE_EXCLUSIVE 0x00000010 |
| #define STGM_PRIORITY 0x00040000 |
| #define STGM_DELETEONRELEASE 0x04000000 |
| #define STGM_CREATE 0x00001000 |
| #define STGM_CONVERT 0x00020000 |
| #define STGM_FAILIFTHERE 0x00000000 |
| #define STGM_NOSCRATCH 0x00100000 |
| #define STGM_NOSNAPSHOT 0x00200000 |
| |
| HRESULT WINAPI StgCreateDocFile16(LPCOLESTR16 pwcsName,DWORD grfMode,DWORD reserved,IStorage16 **ppstgOpen); |
| HRESULT WINAPI StgCreateDocfile(LPCOLESTR pwcsName,DWORD grfMode,DWORD reserved,IStorage **ppstgOpen); |
| |
| HRESULT WINAPI StgIsStorageFile16(LPCOLESTR16 fn); |
| HRESULT WINAPI StgIsStorageFile(LPCOLESTR fn); |
| HRESULT WINAPI StgIsStorageILockBytes(ILockBytes *plkbyt); |
| |
| HRESULT WINAPI StgOpenStorage16(const OLECHAR16* pwcsName,IStorage16* pstgPriority,DWORD grfMode,SNB16 snbExclude,DWORD reserved,IStorage16**ppstgOpen); |
| HRESULT WINAPI StgOpenStorage(const OLECHAR* pwcsName,IStorage* pstgPriority,DWORD grfMode,SNB snbExclude,DWORD reserved,IStorage**ppstgOpen); |
| |
| HRESULT WINAPI WriteClassStg(IStorage* pStg, REFCLSID rclsid); |
| HRESULT WINAPI ReadClassStg(IStorage *pstg,CLSID *pclsid); |
| |
| HRESULT WINAPI StgCreateDocfileOnILockBytes(ILockBytes *plkbyt,DWORD grfMode, DWORD reserved, IStorage** ppstgOpen); |
| HRESULT WINAPI StgOpenStorageOnILockBytes(ILockBytes *plkbyt, IStorage *pstgPriority, DWORD grfMode, SNB snbExclude, DWORD reserved, IStorage **ppstgOpen); |
| |
| #ifdef __cplusplus |
| } |
| #endif |
| |
| /***************************************************************************** |
| * Macros to define a COM interface |
| */ |
| /* |
| * The goal of the following set of definitions is to provide a way to use the same |
| * header file definitions to provide both a C interface and a C++ object oriented |
| * interface to COM interfaces. The type of interface is selected automatically |
| * depending on the language but it is always possible to get the C interface in C++ |
| * by defining CINTERFACE. |
| * |
| * It is based on the following assumptions: |
| * - all COM interfaces derive from IUnknown, this should not be a problem. |
| * - the header file only defines the interface, the actual fields are defined |
| * separately in the C file implementing the interface. |
| * |
| * The natural approach to this problem would be to make sure we get a C++ class and |
| * virtual methods in C++ and a structure with a table of pointer to functions in C. |
| * Unfortunately the layout of the virtual table is compiler specific, the layout of |
| * g++ virtual tables is not the same as that of an egcs virtual table which is not the |
| * same as that generated by Visual C+. There are workarounds to make the virtual tables |
| * compatible via padding but unfortunately the one which is imposed to the WINE emulator |
| * by the Windows binaries, i.e. the Visual C++ one, is the most compact of all. |
| * |
| * So the solution I finally adopted does not use virtual tables. Instead I use inline |
| * non virtual methods that dereference the method pointer themselves and perform the call. |
| * |
| * Let's take Direct3D as an example: |
| * |
| * #define INTERFACE IDirect3D |
| * #define IDirect3D_METHODS \ |
| * STDMETHOD(Initialize)(THIS_ REFIID) PURE; \ |
| * STDMETHOD(EnumDevices)(THIS_ LPD3DENUMDEVICESCALLBACK, LPVOID) PURE; \ |
| * STDMETHOD(CreateLight)(THIS_ LPDIRECT3DLIGHT*, IUnknown*) PURE; \ |
| * STDMETHOD(CreateMaterial)(THIS_ LPDIRECT3DMATERIAL*, IUnknown*) PURE; \ |
| * STDMETHOD(CreateViewport)(THIS_ LPDIRECT3DVIEWPORT*, IUnknown*) PURE; \ |
| * STDMETHOD(FindDevice)(THIS_ LPD3DFINDDEVICESEARCH, LPD3DFINDDEVICERESULT) PURE; |
| * #define IDirect3D_IMETHODS \ |
| * IUnknown_IMETHODS \ |
| * IDirect3D_METHODS |
| * ICOM_DEFINE(IDirect3D,IUnknown) |
| * #undef INTERFACE |
| * |
| * #ifdef ICOM_CINTERFACE |
| * // *** IUnknown methods *** // |
| * #define IDirect3D_QueryInterface(p,a,b) ICOM_CALL2(QueryInterface,p,a,b) |
| * #define IDirect3D_AddRef(p) ICOM_CALL (AddRef,p) |
| * #define IDirect3D_Release(p) ICOM_CALL (Release,p) |
| * // *** IDirect3D methods *** // |
| * #define IDirect3D_Initialize(p,a) ICOM_CALL1(Initialize,p,a) |
| * #define IDirect3D_EnumDevices(p,a,b) ICOM_CALL2(EnumDevice,p,a,b) |
| * #define IDirect3D_CreateLight(p,a,b) ICOM_CALL2(CreateLight,p,a,b) |
| * #define IDirect3D_CreateMaterial(p,a,b) ICOM_CALL2(CreateMaterial,p,a,b) |
| * #define IDirect3D_CreateViewport(p,a,b) ICOM_CALL2(CreateViewport,p,a,b) |
| * #define IDirect3D_FindDevice(p,a,b) ICOM_CALL2(FindDevice,p,a,b) |
| * #endif |
| * |
| * Comments: |
| * - The INTERFACE macro is used in the STDMETHOD macros to define the type of the 'this' |
| * pointer. Defining this macro here saves us the trouble of having to repeat the interface |
| * name everywhere. Note however that because of the way macros work, a macro like STDMETHOD |
| * cannot use 'INTERFACE##_VTABLE' because this would give 'INTERFACE_VTABLE' and not |
| * 'IDirect3D_VTABLE'. |
| * - ICOM_METHODS defines the methods specific to this interface. It is then aggregated with the |
| * inherited methods to form ICOM_IMETHODS. |
| * - ICOM_IMETHODS defines the list of methods that are inheritable from this interface. It must |
| * be written manually (rather than using a macro to generate the equivalent code) to avoid |
| * macro recursion (which compilers don't like). |
| * - The ICOM_DEFINE finally declares all the structures necessary for the interface. We have to |
| * explicitly use the interface name for macro expansion reasons again. |
| * Inherited methods are inherited in C by using the IDirect3D_METHODS macro and the parent's |
| * Xxx_IMETHODS macro. In C++ we need only use the IDirect3D_METHODS since method inheritance |
| * is taken care of by the language. |
| * - The 'undef INTERFACE' is here to remind you that using INTERFACE in the following macros |
| * will not work. This time it's because the ICOM_CALL macro expansion is done only once the |
| * 'IDirect3D_Xxx' macro is expanded. And by that time INTERFACE will be long gone anyway. |
| * - Finally the set of 'IDirect3D_Xxx' macros is a standard set of macros defined to ease access |
| * to the interface methods in C. Unfortunately I don't see any way to avoid having to duplicate |
| * the inherited method definitions there. This time I could have used a trick to use only one |
| * macro whatever the number of parameters but I prefered to have it work the same way as above. |
| * - You probably have noticed that we don't define the fields we need to actually implement this |
| * interface: reference count, pointer to other resources and miscellaneous fields. That's |
| * because these interfaces are just that: interfaces. They may be implemented more than once, in |
| * different contexts and sometimes not even in Wine. Thus it would not make sense to impose |
| * that the interface contains some specific fields. |
| * |
| * |
| * In C this gives: |
| * typedef struct IDirect3DVtbl IDirect3DVtbl; |
| * struct IDirect3D { |
| * IDirect3DVtbl* lpVtbl; |
| * }; |
| * struct IDirect3DVtbl { |
| * HRESULT (*QueryInterface)(IDirect3D* me, REFIID riid, LPVOID* ppvObj); |
| * ULONG (*QueryInterface)(IDirect3D* me); |
| * ULONG (*QueryInterface)(IDirect3D* me); |
| * HRESULT (*Initialize)(IDirect3D* me, REFIID a); |
| * HRESULT (*EnumDevices)(IDirect3D* me, LPD3DENUMDEVICESCALLBACK a, LPVOID b); |
| * HRESULT (*CreateLight)(IDirect3D* me, LPDIRECT3DLIGHT* a, IUnknown* b); |
| * HRESULT (*CreateMaterial)(IDirect3D* me, LPDIRECT3DMATERIAL* a, IUnknown* b); |
| * HRESULT (*CreateViewport)(IDirect3D* me, LPDIRECT3DVIEWPORT* a, IUnknown* b); |
| * HRESULT (*FindDevice)(IDirect3D* me, LPD3DFINDDEVICESEARCH a, LPD3DFINDDEVICERESULT b); |
| * }; |
| * |
| * #ifdef ICOM_CINTERFACE |
| * // *** IUnknown methods *** // |
| * #define IDirect3D_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b) |
| * #define IDirect3D_AddRef(p) (p)->lpVtbl->AddRef(p) |
| * #define IDirect3D_Release(p) (p)->lpVtbl->Release(p) |
| * // *** IDirect3D methods *** // |
| * #define IDirect3D_Initialize(p,a) (p)->lpVtbl->Initialize(p,a) |
| * #define IDirect3D_EnumDevices(p,a,b) (p)->lpVtbl->EnumDevice(p,a,b) |
| * #define IDirect3D_CreateLight(p,a,b) (p)->lpVtbl->CreateLight(p,a,b) |
| * #define IDirect3D_CreateMaterial(p,a,b) (p)->lpVtbl->CreateMaterial(p,a,b) |
| * #define IDirect3D_CreateViewport(p,a,b) (p)->lpVtbl->CreateViewport(p,a,b) |
| * #define IDirect3D_FindDevice(p,a,b) (p)->lpVtbl->FindDevice(p,a,b) |
| * #endif |
| * |
| * Comments: |
| * - IDirect3D only contains a pointer to the IDirect3D virtual/jump table. This is the only thing |
| * the user needs to know to use the interface. Of course the structure we will define to |
| * implement this interface will have more fields but the first one will match this pointer. |
| * - The code generated by ICOM_DEFINE defines both the structure representing the interface and |
| * the structure for the jump table. ICOM_DEFINE uses the parent's Xxx_IMETHODS macro to |
| * automatically repeat the prototypes of all the inherited methods and then uses IDirect3D_METHODS |
| * to define the IDirect3D methods. |
| * - Each method is declared as a pointer to function field in the jump table. The implementation |
| * will fill this jump table with appropriate values, probably using a static variable, and |
| * initialize the lpVtbl field to point to this variable. |
| * - The IDirect3D_Xxx macros then just derefence the lpVtbl pointer and use the function pointer |
| * corresponding to the macro name. This emulates the behavior of a virtual table and should be |
| * just as fast. |
| * - This C code should be quite compatible with the Windows headers both for code that uses COM |
| * interfaces and for code implementing a COM interface. |
| * |
| * |
| * And in C++ (with gcc's g++): |
| * |
| * typedef struct IDirect3D: public IUnknown { |
| * virtual HRESULT Initialize(REFIID a) = 0; |
| * virtual HRESULT EnumDevices(LPD3DENUMDEVICESCALLBACK a, LPVOID b) = 0; |
| * virtual HRESULT CreateLight(LPDIRECT3DLIGHT* a, IUnknown* b) = 0; |
| * virtual HRESULT CreateMaterial(LPDIRECT3DMATERIAL* a, IUnknown* b) = 0; |
| * virtual HRESULT CreateViewport(LPDIRECT3DVIEWPORT* a, IUnknown* b) = 0; |
| * virtual HRESULT FindDevice(LPD3DFINDDEVICESEARCH a, LPD3DFINDDEVICERESULT b) = 0; |
| * }; |
| * |
| * Comments: |
| * - Of course in C++ we use inheritance so that we don't have to duplicate the method definitions. |
| * - Finally there is no IDirect3D_Xxx macro. These are not needed in C++ unless the CINTERFACE |
| * macro is defined in which case we would not be here. |
| * |
| * |
| * Implementing a COM interface. |
| * |
| * This continues the above example. This example assumes that the implementation is in C. |
| * |
| * typedef struct _IDirect3D { |
| * void* lpVtbl; |
| * // ... |
| * |
| * } _IDirect3D; |
| * |
| * static ICOM_VTABLE(IDirect3D) d3dvt; |
| * |
| * // implement the IDirect3D methods here |
| * |
| * int IDirect3D_QueryInterface(IDirect3D* me) |
| * { |
| * ICOM_THIS(IDirect3D,me); |
| * // ... |
| * } |
| * |
| * // ... |
| * |
| * static ICOM_VTABLE(IDirect3D) d3dvt = { |
| * ICOM_MSVTABLE_COMPAT_DummyRTTIVALUE |
| * IDirect3D_QueryInterface, |
| * IDirect3D_Add, |
| * IDirect3D_Add2, |
| * IDirect3D_Initialize, |
| * IDirect3D_SetWidth |
| * }; |
| * |
| * Comments: |
| * - We first define what the interface really contains. This is th e_IDirect3D structure. The |
| * first field must of course be the virtual table pointer. Everything else is free. |
| * - Then we predeclare our static virtual table variable, we will need its address in some |
| * methods to initialize the virtual table pointer of the returned interface objects. |
| * - Then we implement the interface methods. To match what has been declared in the header file |
| * they must take a pointer to a IDirect3D structure and we must cast it to an _IDirect3D so that |
| * we can manipulate the fields. This is performed by the ICOM_THIS macro. |
| * - Finally we initialize the virtual table. |
| */ |
| |
| |
| |
| #if !defined(__cplusplus) || defined(CINTERFACE) |
| #define ICOM_CINTERFACE 1 |
| #endif |
| |
| #ifndef ICOM_CINTERFACE |
| |
| /* C++ interface */ |
| |
| #define STDMETHOD(method) virtual HRESULT STDMETHODCALLTYPE method |
| #define STDMETHOD_(type,method) virtual type STDMETHODCALLTYPE method |
| #define STDMETHODV(method) virtual HRESULT STDMETHODVCALLTYPE method |
| #define STDMETHODV_(type,method) virtual type STDMETHODVCALLTYPE method |
| |
| #define PURE = 0 |
| #define THIS_ |
| #define THIS void |
| |
| #define interface struct |
| #define DECLARE_INTERFACE(iface) interface iface |
| #define DECLARE_INTERFACE_(iface,ibase) interface iface : public ibase |
| |
| #define BEGIN_INTERFACE |
| #define END_INTERFACE |
| |
| /* Wine-specific macros */ |
| |
| #define ICOM_DEFINE(iface,ibase) \ |
| DECLARE_INTERFACE_(iface,ibase) { \ |
| iface##_METHODS \ |
| } ICOM_COM_INTERFACE_ATTRIBUTE; |
| |
| #define ICOM_VTBL(iface) (iface) |
| |
| #else /* ICOM_CINTERFACE */ |
| |
| /* C interface */ |
| |
| #define STDMETHOD(method) HRESULT (STDMETHODCALLTYPE *method) |
| #define STDMETHOD_(type,method) type (STDMETHODCALLTYPE *method) |
| #define STDMETHODV(method) HRESULT (STDMETHODVCALLTYPE *method) |
| #define STDMETHODV_(type,method) type (STDMETHODVCALLTYPE *method) |
| |
| #define PURE |
| #define THIS_ INTERFACE *This, |
| #define THIS INTERFACE *This |
| |
| #define interface struct |
| |
| #ifdef CONST_VTABLE |
| #undef CONST_VTBL |
| #define CONST_VTBL const |
| #define DECLARE_INTERFACE(iface) \ |
| /*typedef*/ interface iface { const struct iface##Vtbl *lpVtbl; } /*iface*/; \ |
| typedef const struct iface##Vtbl iface##Vtbl; \ |
| const struct iface##Vtbl |
| #else |
| #undef CONST_VTBL |
| #define CONST_VTBL |
| #define DECLARE_INTERFACE(iface) \ |
| /*typedef*/ interface iface { struct iface##Vtbl *lpVtbl; } /*iface*/; \ |
| typedef struct iface##Vtbl iface##Vtbl; \ |
| struct iface##Vtbl |
| #endif |
| #define DECLARE_INTERFACE_(iface,ibase) DECLARE_INTERFACE(iface) |
| |
| #define BEGIN_INTERFACE |
| #define END_INTERFACE |
| |
| /* Wine-specific macros */ |
| |
| #define ICOM_DEFINE(iface,ibase) \ |
| DECLARE_INTERFACE_(iface,ibase) { \ |
| ICOM_MSVTABLE_COMPAT_FIELDS \ |
| ibase##_IMETHODS \ |
| iface##_METHODS \ |
| }; |
| |
| #define ICOM_VTABLE(iface) iface##Vtbl |
| #define ICOM_VFIELD(iface) ICOM_VTABLE(iface)* lpVtbl |
| #define ICOM_VTBL(iface) (iface)->lpVtbl |
| |
| #define ICOM_THIS(impl,iface) impl* const This=(impl*)(iface) |
| #define ICOM_CTHIS(impl,iface) const impl* const This=(const impl*)(iface) |
| |
| #define ICOM_THIS_MULTI(impl,field,iface) impl* const This=(impl*)((char*)(iface) - offsetof(impl,field)) |
| #define ICOM_CTHIS_MULTI(impl,field,iface) const impl* const This=(const impl*)((char*)(iface) - offsetof(impl,field)) |
| |
| #endif /* ICOM_CINTERFACE */ |
| |
| #define ICOM_CALL(xfn, ptr) ICOM_VTBL(ptr)->xfn(ptr) |
| #define ICOM_CALL1(xfn, ptr,a) ICOM_VTBL(ptr)->xfn(ptr,a) |
| #define ICOM_CALL2(xfn, ptr,a,b) ICOM_VTBL(ptr)->xfn(ptr,a,b) |
| #define ICOM_CALL3(xfn, ptr,a,b,c) ICOM_VTBL(ptr)->xfn(ptr,a,b,c) |
| #define ICOM_CALL4(xfn, ptr,a,b,c,d) ICOM_VTBL(ptr)->xfn(ptr,a,b,c,d) |
| #define ICOM_CALL5(xfn, ptr,a,b,c,d,e) ICOM_VTBL(ptr)->xfn(ptr,a,b,c,d,e) |
| #define ICOM_CALL6(xfn, ptr,a,b,c,d,e,f) ICOM_VTBL(ptr)->xfn(ptr,a,b,c,d,e,f) |
| #define ICOM_CALL7(xfn, ptr,a,b,c,d,e,f,g) ICOM_VTBL(ptr)->xfn(ptr,a,b,c,d,e,f,g) |
| #define ICOM_CALL8(xfn, ptr,a,b,c,d,e,f,g,h) ICOM_VTBL(ptr)->xfn(ptr,a,b,c,d,e,f,g,h) |
| #define ICOM_CALL9(xfn, ptr,a,b,c,d,e,f,g,h,i) ICOM_VTBL(ptr)->xfn(ptr,a,b,c,d,e,f,g,h,i) |
| #define ICOM_CALL10(xfn, ptr,a,b,c,d,e,f,g,h,i,j) ICOM_VTBL(ptr)->xfn(ptr,a,b,c,d,e,f,g,h,i,j) |
| #define ICOM_CALL11(xfn, ptr,a,b,c,d,e,f,g,h,i,j,k) ICOM_VTBL(ptr)->xfn(ptr,a,b,c,d,e,f,g,h,i,j,k) |
| #define ICOM_CALL12(xfn, ptr,a,b,c,d,e,f,g,h,i,j,k,l) ICOM_VTBL(ptr)->xfn(ptr,a,b,c,d,e,f,g,h,i,j,k,l) |
| #define ICOM_CALL13(xfn, ptr,a,b,c,d,e,f,g,h,i,j,k,l,m) ICOM_VTBL(ptr)->xfn(ptr,a,b,c,d,e,f,g,h,i,j,k,l,m) |
| #define ICOM_CALL14(xfn, ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n) ICOM_VTBL(ptr)->xfn(ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n) |
| #define ICOM_CALL15(xfn, ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o) ICOM_VTBL(ptr)->xfn(ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o) |
| #define ICOM_CALL16(xfn, ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p) ICOM_VTBL(ptr)->xfn(ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p) |
| #define ICOM_CALL17(xfn, ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q) ICOM_VTBL(ptr)->xfn(ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q) |
| #define ICOM_CALL18(xfn, ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r) ICOM_VTBL(ptr)->xfn(ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r) |
| #define ICOM_CALL19(xfn, ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s) ICOM_VTBL(ptr)->xfn(ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s) |
| #define ICOM_CALL20(xfn, ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t) ICOM_VTBL(ptr)->xfn(ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t) |
| #define ICOM_CALL21(xfn, ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u) ICOM_VTBL(ptr)->xfn(ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u) |
| #define ICOM_CALL22(xfn, ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v) ICOM_VTBL(ptr)->xfn(ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v) |
| #define ICOM_CALL23(xfn, ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w) ICOM_VTBL(ptr)->xfn(ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w) |
| #define ICOM_CALL24(xfn, ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w,x) ICOM_VTBL(ptr)->xfn(ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w,x) |
| #define ICOM_CALL25(xfn, ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w,x,y) ICOM_VTBL(ptr)->xfn(ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w,x,y) |
| #define ICOM_CALL26(xfn, ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w,x,y,z) ICOM_VTBL(ptr)->xfn(ptr,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w,x,y,z) |
| |
| |
| #ifndef __WINESRC__ |
| |
| #define FARSTRUCT |
| #define HUGEP |
| |
| #define WINOLEAPI STDAPI |
| #define WINOLEAPI_(type) STDAPI_(type) |
| |
| #endif /* __WINESRC__ */ |
| |
| #endif /* _OBJBASE_H_ */ |
