2 * Copyright (C) 2007 Apple Inc. All rights reserved.
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
13 * 3. Neither the name of Apple Computer, Inc. ("Apple") nor the names of
14 * its contributors may be used to endorse or promote products derived
15 * from this software without specific prior written permission.
17 * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY
18 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
19 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
20 * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY
21 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
22 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
23 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
24 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
33 #include <wtf/Assertions.h>
35 #define SOFT_LINK_LIBRARY_HELPER(lib, suffix) \
36 static HMODULE lib##Library() \
38 static HMODULE library = LoadLibraryW(L###lib suffix); \
43 #define SOFT_LINK_GETPROCADDRESS GetProcAddressA
45 #define SOFT_LINK_GETPROCADDRESS GetProcAddress
48 #define SOFT_LINK_LIBRARY(lib) SOFT_LINK_LIBRARY_HELPER(lib, L".dll")
49 #define SOFT_LINK_DEBUG_LIBRARY(lib) SOFT_LINK_LIBRARY_HELPER(lib, L"_debug.dll")
51 #define SOFT_LINK(library, functionName, resultType, callingConvention, parameterDeclarations, parameterNames) \
52 static resultType callingConvention init##functionName parameterDeclarations; \
53 static resultType (callingConvention*softLink##functionName) parameterDeclarations = init##functionName; \
55 static resultType callingConvention init##functionName parameterDeclarations \
57 softLink##functionName = reinterpret_cast<resultType (callingConvention*) parameterDeclarations>(SOFT_LINK_GETPROCADDRESS(library##Library(), #functionName)); \
58 ASSERT(softLink##functionName); \
59 return softLink##functionName parameterNames; \
62 inline resultType functionName parameterDeclarations \
64 return softLink##functionName parameterNames; \
67 #define SOFT_LINK_OPTIONAL(library, functionName, resultType, callingConvention, parameterDeclarations) \
68 typedef resultType (callingConvention *functionName##PtrType) parameterDeclarations; \
69 static functionName##PtrType functionName##Ptr() \
71 static functionName##PtrType ptr; \
72 static bool initialized; \
78 ptr = reinterpret_cast<functionName##PtrType>(SOFT_LINK_GETPROCADDRESS(library##Library(), #functionName)); \
83 In order to soft link against functions decorated with __declspec(dllimport), we prepend "softLink_" to the function names.
84 If you use SOFT_LINK_DLL_IMPORT(), you will also need to #define the function name to account for this, e.g.:
86 SOFT_LINK_DLL_IMPORT(myLibrary, myFunction, ...)
87 #define myFunction softLink_myFunction
89 #define SOFT_LINK_DLL_IMPORT(library, functionName, resultType, callingConvention, parameterDeclarations, parameterNames) \
90 static resultType callingConvention init##functionName parameterDeclarations; \
91 static resultType(callingConvention*softLink##functionName) parameterDeclarations = init##functionName; \
93 static resultType callingConvention init##functionName parameterDeclarations \
95 softLink##functionName = reinterpret_cast<resultType (callingConvention*)parameterDeclarations>(SOFT_LINK_GETPROCADDRESS(library##Library(), #functionName)); \
96 ASSERT(softLink##functionName); \
97 return softLink##functionName parameterNames; \
100 inline resultType softLink_##functionName parameterDeclarations \
102 return softLink##functionName parameterNames; \
106 Variables exported by a DLL need to be accessed through a function.
107 If you use SOFT_LINK_VARIABLE_DLL_IMPORT(), you will also need to #define the variable name to account for this, e.g.:
109 SOFT_LINK_VARIABLE_DLL_IMPORT(myLibrary, myVar, int)
110 #define myVar get_myVar()
112 #define SOFT_LINK_VARIABLE_DLL_IMPORT(library, variableName, variableType) \
113 static variableType get_##variableName() \
115 static variableType* ptr = reinterpret_cast<variableType*>(SOFT_LINK_GETPROCADDRESS(library##Library(), #variableName)); \
120 #endif // SoftLinking_h