- C#動態調用C++編寫的DLL函數
-
動態加載DLL需要使用Windows API函數：LoadLibrary、GetProcAddress以及FreeLibrary。我們可以使用DllImport在C#中使用這三個函數。
[DllImport("Kernel32")]
public static extern int GetProcAddress(int handle, String funcname);
[DllImport("Kernel32")]
public static extern int LoadLibrary(String funcname);
[DllImport("Kernel32")]
public static extern int FreeLibrary(int handle);
當我們在C++中動態調用Dll中的函數時，我們一般的方法是：
假設DLL中有一個導出函數，函數原型如下：
BOOL __stdcall foo(Object &object, LPVOID lpReserved);
1、首先定義相應的函數指針：
typedef BOOL (__stdcall *PFOO)(Object &object, LPVOID lpReserved);
2、調用LoadLibrary加載dll：
HINSTANCE hInst = ::LoadLibraryW(dllFileName);
3、調用GetProcAddress函數獲取要調用函數的地址：
PFOO foo = (PFOO)GetProcAddress(hInst,"foo");
if(foo == NULL)
{
FreeLibrary(hInst);
return false;
}
4、調用foo函數：
BOOL bRet = foo(object,(LPVOID)NULL);
5、使用完后應釋放DLL：
FreeLibrary(hInst);
那么在C#中應該怎么做呢？方法基本上一樣，我們使用委托來代替C++的函數指針，通過.NET Framework 2.0新增的函數GetDelegateForFunctionPointer來得到一個委托的實例：
下面封裝了一個類，通過該類我們就可以在C#中動態調用Dll中的函數了：
public class DLLWrapper
{
///<summary>
/// API LoadLibrary
///</summary>
[DllImport("Kernel32")]
public static extern int LoadLibrary(String funcname);
///<summary>
/// API GetProcAddress
///</summary>
[DllImport("Kernel32")]
public static extern int GetProcAddress(int handle, String funcname);
///<summary>
/// API FreeLibrary
///</summary>
[DllImport("Kernel32")]
public static extern int FreeLibrary(int handle);
///<summary>
///通過非托管函數名轉換為對應的委托, by jingzhongrong
///</summary>
///<param name="dllModule">通過LoadLibrary獲得的DLL句柄</param>
///<param name="functionName">非托管函數名</param>
///<param name="t">對應的委托類型</param>
///<returns>委托實例，可強制轉換為適當的委托類型</returns>
public static Delegate GetFunctionAddress(int dllModule, string functionName, Type t)
{
int address = GetProcAddress(dllModule, functionName);
if (address == 0)
return null;
else
return Marshal.GetDelegateForFunctionPointer(new IntPtr(address), t);
}
///<summary>
///將表示函數地址的IntPtr實例轉換成對應的委托, by jingzhongrong
///</summary>
public static Delegate GetDelegateFromIntPtr(IntPtr address, Type t)
{
if (address == IntPtr.Zero)
return null;
else
return Marshal.GetDelegateForFunctionPointer(address, t);
}
///<summary>
///將表示函數地址的int轉換成對應的委托，by jingzhongrong
///</summary>
public static Delegate GetDelegateFromIntPtr(int address, Type t)
{
if (address == 0)
return null;
else
return Marshal.GetDelegateForFunctionPointer(new IntPtr(address), t);
}
}
通過這個類，我們這樣調用DLL：
1、聲明相應的委托（正確聲明很重要，否則不能調用成功，后面有詳細介紹）。
2、加載DLL：
int hModule = DLLWrapper.LoadLibrary(dllFilePath);
if (hModule == 0)
return false;
3、獲取相應的委托實例：
FOO foo = (FOO)DLLWrapper.GetFunctionAddress(hModule, "foo", typeof(FOO));
if (foo == null)
{
DLLWrapper.FreeLibrary(hModule);
return false;
}
4、調用函數：
foo(...);
5、.NET並不能自動釋放動態加載的DLL，因此我們在使用完DLL后應該自己釋放DLL：
DLLWrapper.FreeLibrary(hModule);
下面我們將就委托應如何聲明進行相應的討論，在實際操作過程中，我發現使用DllImport方法和動態調用方法兩者在C#中對DLL中函數原型的聲明是有些區別的，下面我介紹動態調用中委托的聲明：
1、首先應該注意的是，C++中的類型和C#中類型的對應關系，比如C++中的long應該對應C#中的Int32而不是long，否則將導致調用結果出錯。
2、結構的聲明使用StructLayout對結構的相應布局進行設置，具體的請查看MSDN：
使用LayoutKind指定結構中成員的布局順序，一般可以使用Sequential：
[StructLayout(LayoutKind.Sequential)]
struct StructVersionInfo
{
public int MajorVersion;
public int MinorVersion;
}
另外，如果單獨使用內部類型沒有另外使用到字符串、結構、類，可以將結構在C#中聲明為class：
[StructLayout(LayoutKind.Sequential)]
class StructVersionInfo
{
public int MajorVersion;
public int MinorVersion;
}
對應C++中的聲明：
typedef struct _VERSION_INFO
{
int MajorVersion;
int MinorVersion;
} VERSION_INFO, *PVERSION_INFO;
如果結構中使用到了字符串，最好應指定相應的字符集：
[StructLayout(LayoutKind.Sequential,CharSet=CharSet.Unicode)]
部分常用的聲明對應關系（在結構中）：
C++：字符串數組
wchar_t Comments[120];
C#：
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 120)]
public string Comments;
C++：結構成員
VERSION_INFO ver;
C#
publicStructVersionInfo ver;
C++：函數指針聲明
PFOO pFoo; //具體聲明見文章前面部分
C#:
publicIntPtr pFoo; //也可以為 public int pFoo;
//不同的聲明方法可以使用上面DLLWrapper類的相應函數獲取對應的委托實例
如果在結構中使用到了union，那么可以使用FieldOffset指定具體位置。
3、委托的聲明：
當C++編寫的DLL函數需要通過指針傳出將一個結構：如以下聲明：
void getVersionInfo(VERSION_INFO *ver);
對於在C#中聲明為class的結構（當VERSION_INFO聲明為class）
delegate voidgetVersionInfo(VERSION_INFO ver);
如果結構聲明為struct，那么應該使用如下聲明：
delegate voidgetVersionInfo(refVERSION_INFO ver);
注意：應該使用ref關鍵字。
如果DLL函數需要傳入一個字符串，比如這樣：
BOOL __stdcall jingzhongrong1(const wchar_t* lpFileName, int* FileNum);
那么使用委托來調用函數的時候應該在C#中如下聲明委托：
delegate bool jingzhongrong1(
[MarshalAs(UnmanagedType.LPWStr)]String FileName,
ref int FileNum);
注意：應該使用[MarshalAs(UnmanagedType.LPWStr)]和String進行聲明。
如果要在DLL函數中傳出一個字符串，比如這樣：
void __stdcall jingzhongrong2(
wchar_t* lpFileName, //要傳出的字符串
int* Length);
那么我們如下聲明委托：
//使用委托從非托管函數的參數中傳出的字符串，
//應該這樣聲明，並在調用前為StringBuilder預備足夠的空間
delegate void jingzhongrong2(
[MarshalAs(UnmanagedType.LPWStr)] StringBuilder lpFileName,
ref int Length,
);
在使用函數前，應先為StringBuilder聲明足夠的空間用於存放字符串：
StringBuilder fileName = new StringBuilder(FileNameLength);參考： http://www.2cto.com/kf/201007/52562.html
參考： http://www.codeproject.com/Articles/12121/Essential-P-Invoke
參考： http://www.codeproject.com/Articles/339290/PInvoke-pointer-safety-Replacing-IntPtr-with-unsaf
參考： http://www.dotblogs.com.tw/merlin/archive/2012/07/17/73424.aspx
==============================
(轉載：http://blog.csdn.net/xqf222/article/details/5877795)
//C++中的DLL函數原型為
//extern "C" __declspec(dllexport) bool 方法名一(const char* 變量名1, unsigned char* 變量名2)
//extern "C" __declspec(dllexport) bool 方法名二(const unsigned char* 變量名1, char* 變量名2)//C#調用C++的DLL搜集整理的所有數據類型轉換方式,可能會有重復或者多種方案,自己多測試
//c++:HANDLE(void *) ---- c#:System.IntPtr
//c++:Byte(unsigned char) ---- c#:System.Byte
//c++:SHORT(short) ---- c#:System.Int16
//c++:WORD(unsigned short) ---- c#:System.UInt16
//c++:INT(int) ---- c#:System.Int16
//c++:INT(int) ---- c#:System.Int32
//c++:UINT(unsigned int) ---- c#:System.UInt16
//c++:UINT(unsigned int) ---- c#:System.UInt32
//c++:LONG(long) ---- c#:System.Int32
//c++:ULONG(unsigned long) ---- c#:System.UInt32
//c++:DWORD(unsigned long) ---- c#:System.UInt32
//c++:DECIMAL ---- c#:System.Decimal
//c++:BOOL(long) ---- c#:System.Boolean
//c++:CHAR(char) ---- c#:System.Char
//c++:LPSTR(char *) ---- c#:System.String
//c++:LPWSTR(wchar_t *) ---- c#:System.String
//c++:LPCSTR(const char *) ---- c#:System.String
//c++:LPCWSTR(const wchar_t *) ---- c#:System.String
//c++:PCAHR(char *) ---- c#:System.String
//c++:BSTR ---- c#:System.String
//c++:FLOAT(float) ---- c#:System.Single
//c++:DOUBLE(double) ---- c#:System.Double
//c++:VARIANT ---- c#:System.Object
//c++:PBYTE(byte *) ---- c#:System.Byte[]//c++:BSTR ---- c#:StringBuilder
//c++:LPCTSTR ---- c#:StringBuilder
//c++:LPCTSTR ---- c#:string
//c++:LPTSTR ---- c#:[MarshalAs(UnmanagedType.LPTStr)] string
//c++:LPTSTR 輸出變量名 ---- c#:StringBuilder 輸出變量名
//c++:LPCWSTR ---- c#:IntPtr
//c++:BOOL ---- c#:bool
//c++:HMODULE ---- c#:IntPtr
//c++:HINSTANCE ---- c#:IntPtr
//c++:結構體 ---- c#:public struct 結構體{};
//c++:結構體 **變量名 ---- c#:out 變量名 //C#中提前申明一個結構體實例化后的變量名
//c++:結構體 &變量名 ---- c#:ref 結構體 變量名
//c++:WORD ---- c#:ushort
//c++:DWORD ---- c#:uint
//c++:DWORD ---- c#:int//c++:UCHAR ---- c#:int
//c++:UCHAR ---- c#:byte
//c++:UCHAR* ---- c#:string
//c++:UCHAR* ---- c#:IntPtr//c++:GUID ---- c#:Guid
//c++:Handle ---- c#:IntPtr
//c++:HWND ---- c#:IntPtr
//c++:DWORD ---- c#:int
//c++:COLORREF ---- c#:uint
//c++:unsigned char ---- c#:byte
//c++:unsigned char * ---- c#:ref byte
//c++:unsigned char * ---- c#:[MarshalAs(UnmanagedType.LPArray)] byte[]
//c++:unsigned char * ---- c#:[MarshalAs(UnmanagedType.LPArray)] Intptr//c++:unsigned char & ---- c#:ref byte
//c++:unsigned char 變量名 ---- c#:byte 變量名
//c++:unsigned short 變量名 ---- c#:ushort 變量名
//c++:unsigned int 變量名 ---- c#:uint 變量名
//c++:unsigned long 變量名 ---- c#:ulong 變量名//c++:char 變量名 ---- c#:byte 變量名 //C++中一個字符用一個字節表示,C#中一個字符用兩個字節表示
//c++:char 數組名[數組大小] ---- c#:MarshalAs(UnmanagedType.ByValTStr, SizeConst = 數組大小)] public string 數組名; ushort//c++:char * ---- c#:string //傳入參數
//c++:char * ---- c#:StringBuilder//傳出參數
//c++:char *變量名 ---- c#:ref string 變量名
//c++:char *輸入變量名 ---- c#:string 輸入變量名
//c++:char *輸出變量名 ---- c#:[MarshalAs(UnmanagedType.LPStr)] StringBuilder 輸出變量名//c++:char ** ---- c#:string
//c++:char **變量名 ---- c#:ref string 變量名
//c++:const char * ---- c#:string
//c++:char[] ---- c#:string
//c++:char 變量名[數組大小] ---- c#:[MarshalAs(UnmanagedType.ByValTStr,SizeConst=數組大小)] public string 變量名;//c++:struct 結構體名 *變量名 ---- c#:ref 結構體名 變量名
//c++:委托 變量名 ---- c#:委托 變量名//c++:int ---- c#:int
//c++:int ---- c#:ref int
//c++:int & ---- c#:ref int
//c++:int * ---- c#:ref int //C#中調用前需定義int 變量名 = 0;//c++:*int ---- c#:IntPtr
//c++:int32 PIPTR * ---- c#:int32[]
//c++:float PIPTR * ---- c#:float[]
//c++:double** 數組名 ---- c#:ref double 數組名
//c++:double*[] 數組名 ---- c#:ref double 數組名
//c++:long ---- c#:int
//c++:ulong ---- c#:int
//c++:UINT8 * ---- c#:ref byte //C#中調用前需定義byte 變量名 = new byte();
//c++:handle ---- c#:IntPtr
//c++:hwnd ---- c#:IntPtr
//c++:void * ---- c#:IntPtr
//c++:void * user_obj_param ---- c#:IntPtr user_obj_param
//c++:void * 對象名稱 ---- c#:([MarshalAs(UnmanagedType.AsAny)]Object 對象名稱
//c++:char, INT8, SBYTE, CHAR ---- c#:System.SByte
//c++:short, short int, INT16, SHORT ---- c#:System.Int16
//c++:int, long, long int, INT32, LONG32, BOOL , INT ---- c#:System.Int32
//c++:__int64, INT64, LONGLONG ---- c#:System.Int64
//c++:unsigned char, UINT8, UCHAR , BYTE ---- c#:System.Byte
//c++:unsigned short, UINT16, USHORT, WORD, ATOM, WCHAR , __wchar_t ---- c#:System.UInt16
//c++:unsigned, unsigned int, UINT32, ULONG32, DWORD32, ULONG, DWORD, UINT ---- c#:System.UInt32
//c++:unsigned __int64, UINT64, DWORDLONG, ULONGLONG ---- c#:System.UInt64
//c++:float, FLOAT ---- c#:System.Single
//c++:double, long double, DOUBLE ---- c#:System.Double//Win32 Types ---- CLR Type
//Struct需要在C#里重新定義一個Struct
//CallBack回調函數需要封裝在一個委托里，delegate static extern int FunCallBack(string str);//unsigned char** ppImage替換成IntPtr ppImage
//int& nWidth替換成ref int nWidth
//int*, int&, 則都可用 ref int 對應
//雙針指類型參數，可以用 ref IntPtr
//函數指針使用c++: typedef double (*fun_type1)(double); 對應 c#:public delegate double fun_type1(double);
//char* 的操作c++: char*; 對應 c#:StringBuilder;
//c#中使用指針:在需要使用指針的地方 加 unsafe
//unsigned char對應public byte
/*
* typedef void (*CALLBACKFUN1W)(wchar_t*, void* pArg);
* typedef void (*CALLBACKFUN1A)(char*, void* pArg);
* bool BIOPRINT_SENSOR_API dllFun1(CALLBACKFUN1 pCallbackFun1, void* pArg);
* 調用方式為
* [UnmanagedFunctionPointer(CallingConvention.Cdecl)]
* public delegate void CallbackFunc1([MarshalAs(UnmanagedType.LPWStr)] StringBuilder strName, IntPtr pArg);
*
*
*/f you want to pass a byte array to native DLL as parameter, you can use the Intptr to do this, please check the demo below.
//C++ API code:
DEMODLL_API void TestArrayPara(BYTE * pArray, int nSize)
{
for (int i=0; i<nSize; i++)
printf("%d\n", pArray[i]);
}
//C# code:
class Class2
{
[DllImport(@"DemoDll.dll")]
public static extern void TestArrayPara(IntPtr pArray, int nSize);
public static void Test()
{
Console.WriteLine("This is C# program");
byte[] array = new byte[16];
for (int i = 0; i < 16; i++)
{
array[i] = (byte)(i + 97);
}
//============================
int size = Marshal.SizeOf(array[0]) * array.Length;
IntPtr pnt = Marshal.AllocHGlobal(size);
try
{
// Copy the array to unmanaged memory.
Marshal.Copy(array, 0, pnt, array.Length);
}
finally
{
// Free the unmanaged memory.
// Marshal.FreeHGlobal(pnt);
}
//============================
TestArrayPara(pnt, array.Length);
Marshal.FreeHGlobal(pnt);
Console.WriteLine("End of app");
}
}
In addition to Mashal.Copy method, please refer to the following article.