C#调用C++动态链接库dll

最新推荐文章于 2024-05-22 20:58:07 发布

爱喝奶茶的火锅

最新推荐文章于 2024-05-22 20:58:07 发布

阅读量3.4k

点赞数 4

分类专栏： C#

原文链接：https://www.cnblogs.com/zhangweizhong/p/8119340.html

版权

C# 专栏收录该内容

16 篇文章 2 订阅

订阅专栏

C#调用C++动态链接库dll

由于公司很多底层的SDK，都是C++开发，上层的应用软件却是C# Winform程序。在实际工作的过程中，就经常碰到了C# 程序调用C++ 动态库的问题。最近一直在和C++ 打交道，C# 怎么调用C++ 类库函数。也遇到了一些问题，所以就来总结总结C#程序调用C++动态库时的各种坑。

1. 可能遇到的问题：

    C#在调用动态库的过程中我也遇到了以下一些问题：

    1、C++中有指针，C#中需要使用指针吗？

    由于C++中的动态库中有指针参数，因此我也是用.NET的不安全代码，使用了C#的指针，但是也还是出现了一些问题，如在C#中传入的参数是一个二维数组时就出现了问题，最后只能改C++函数传入参数的参数类型。

    2、C#和C++中的类型如何转换呢？

    虽然C#和C++比较类似，但是其给我们的参数类型我们要与C#的参数类型一一对应起来，具体看后续说明。

    3、C++函数中的CallingConventionCharSet 怎么设置？
　　 调用C++函数之前一定要先确认，否则可能出现函数调用导致堆栈不对称。原因可能是托管的 PInvoke 签名与非托管的目标签名不匹配的问题。函数的CallingConvention和CharSet，可以查看动态库对应的 .h头文件。

    4、如何反编译C++的dll的名称，端口？

    可以通过Dependency Walker工具进行反编译查看别人写的动态库的信息

　　 5、指针函数如何传参？

　　 对于函数需要的指针函数，C# 调用时，可以定义委托来传入参数。 

　　 6、需要注意C++ dll 编译的平台是x86还是x64，是多字节的还是双字节的(Unicode)。

2. 通过Dependency Walke查看dll的名称，端口

下载Dependency 后将对应的C++ dll文件加载进去，就尅看到动态库的对应的信息，同时也可以通过.h 头文件查看。
在这里插入图片描述

3. 如何调用

c#调用c++动态库一般我们这样写：

[DllImport(SDK, CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
    public static extern int IKSDK_Release();

	1. DllImport的第一个参数SDK是动态库dll的路径，此dll放在程序运行的根目录或者c:windows/sytem32下，建议在程序根目录创建一个子目录来放置相应的C++ 动态库文件，方便以后更新。 
　　2. CallingConvention 参数是c#调用c++的方式 是个枚举 msdn解释如下：

Cdecl 调用方清理堆栈。这使您能够调用具有 varargs 的函数（如 Printf），使之可用于接受可变数目的参数的方法。
FastCal 不支持此调用约定。
StdCall 被调用方清理堆栈。这是使用平台 invoke 调用非托管函数的默认约定。
ThisCall 第一个参数是 this 指针，它存储在寄存器 ECX 中。其他参数被推送到堆栈上。此调用约定用于对从非托管 DLL 导出的类调用方法。
Winapi 此成员实际上不是调用约定，而是使用了默认平台调用约定。例如，在 Windows 上默认为 StdCall，在 Windows CE.NET 上默认为 Cdecl。
　　3. CharSet参数是控制名称重整以及将字符串参数封送到函数中的方式。默认值为 CharSet.Ansi。
　4. entrypoint参数用于标识函数在 DLL 中的位置。在托管对象中，目标函数的原名或序号入口点将标识跨越交互操作边界的函数。此外，您可以将入口点映射到一个不同的名称，这实际上是将函数重命名。一般默认不设置此参数。
　　5. 其他参数，请查看MSDN对于 DllImportAttribute 的说明。

C#与C++类型对照

函数调用导致堆栈不对称。原因可能是托管的 PInvoke 签名与非托管的目标签名不匹配。
在dllimport中加入CallingConvention参数就行了，

[DllImport(PCAP_DLL, CharSet = CharSet.Auto, CallingConvention = CallingConvention.Cdecl)]

要注意C++与NET中数据类型的对应：

//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++:SHORT(short) ---- c#:System.Int16
//c++:LONG(long) ---- c#:System.Int32

转载收集：

//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#: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);
*/

其他说明

C#调用C++ 链接库的方式分为静态调用和动态调用这两种方式。静态调用之前的文章里面都有介绍，使用.net 提供的DllImport 导入相关的C++ 库即可。
今天介绍动态调用的方法。很多时候，Dll库的目录可能是变化的，或是有些场景，需要根据具体的情况，来动态加载这些Dll库。这样使用静态调用的方式就很不方便，C#中我们经常通过配置动态的调用托管Dll，那么是不是也可以这样动态调用C++动态链接呢？
只要通过LoadLibrary, GetProcess, FreeLibrary这几个函数是可以动态调用动态链接的（它们包含在kernel32.dll中）。

原理

LoadLibrary ( string lpFileName)：载入指定的动态链接库，并将它映射到当前进程使用的地址空间。载入成功后即可访问库内保存的资源，除了LoadLibrary 方法，还有一个类似的 LoadLibraryEx 方法。

GetProcAddress (int hModule, string lpProcName)：GetProcAddress函数检索指定的动态链接库(DLL)中的输出库函数地址。如果函数调用成功，返回值是DLL中的输出函数地址。如果函数调用失败，返回值是NULL。调用函数GetLastError ，得到具体的错误信息。

FreeLibrary ( int hModule) ：释放指定的动态链接库，它们早先是用LoadLibrary API函数装载的。

GetLastError() ：获取错误信息

实现

将kernel32中的几个方法封装成本地调用类 DLLWrapper

using System;
using System.IO;
using System.Runtime.InteropServices;

namespace Irisking.Basic.Util
{
    /// <summary>
    /// DLLWrapper
    /// </summary>
    internal class DLLWrapper
    {
        [DllImport("kernel32.dll")]
        private static extern uint GetLastError();


        /// <summary>
        /// API LoadLibraryEx
        /// </summary>
        /// <param name="lpFileName"></param>
        /// <param name="hReservedNull"></param>
        /// <param name="dwFlags"></param>
        /// <returns></returns>
        [DllImport("kernel32.dll", EntryPoint = "LoadLibraryEx", SetLastError = true)]
        private static extern int LoadLibraryEx(string lpFileName, IntPtr hReservedNull, LoadLibraryFlags dwFlags);

        /// <summary>
        /// API GetProcAddress
        /// </summary>
        /// <param name="handle"></param>
        /// <param name="funcname"></param>
        /// <returns></returns>
        [DllImport("Kernel32", EntryPoint = "GetProcAddress", SetLastError = true)]
        public static extern int GetProcAddress(int handle, string funcname);

        /// <summary>
        ///  API FreeLibrary
        /// </summary>
        /// <param name="handle"></param>
        /// <returns></returns>
        [DllImport("Kernel32", EntryPoint = "FreeLibrary", SetLastError = true)]
        private 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 实例转换成对应的委托
        ///</summary>
        public static Delegate GetDelegateFromIntPtr(IntPtr address, Type t)
        {
            if (address == IntPtr.Zero)
                return null;
            else
                return Marshal.GetDelegateForFunctionPointer(address, t);
        }

        ///<summary>
        /// 将表示函数地址的 int  转换成对应的委托
        ///</summary>
        public static Delegate GetDelegateFromIntPtr(int address, Type t)
        {
            if (address == 0)
                return null;
            else
                return Marshal.GetDelegateForFunctionPointer(new IntPtr(address), t);
        }

        /// <summary>
        /// 加载sdk
        /// </summary>
        /// <param name="lpFileName"></param>
        /// <returns></returns>
        public static int LoadSDK(string lpFileName)
        {
            if (File.Exists(lpFileName))
            {
                var hReservedNull = IntPtr.Zero;
                var dwFlags = LoadLibraryFlags.LOAD_WITH_ALTERED_SEARCH_PATH;

                var result = LoadLibraryEx(lpFileName, hReservedNull, dwFlags);

                var errCode = GetLastError();
                LogHelper.Info($"LoadSDK Result:{result}, ErrorCode: {errCode}");
               
                return result;
            }
            return 0;
        }

        /// <summary>
        /// 释放sdk
        /// </summary>
        /// <param name="handle"></param>
        /// <returns></returns>
        public static int ReleaseSDK(int handle)
        {
            try
            {
                if (handle > 0)
                {
                    LogHelper.Info($"FreeLibrary handle：{handle}");
                    var result = FreeLibrary(handle);
                    var errCode = GetLastError();
                    LogHelper.Info($"FreeLibrary Result:{result}, ErrorCode: {errCode}");
                    return 0;
                }
                return -1;
            }
            catch (Exception ex)
            {
                LogHelper.Error(ex);
                return -1;
            }
        }
    }

    /// <summary>
    /// LoadLibraryFlags
    /// </summary>
    public enum LoadLibraryFlags : uint
    {
        /// <summary>
        /// DONT_RESOLVE_DLL_REFERENCES
        /// </summary>
        DONT_RESOLVE_DLL_REFERENCES = 0x00000001,

        /// <summary>
        /// LOAD_IGNORE_CODE_AUTHZ_LEVEL
        /// </summary>
        LOAD_IGNORE_CODE_AUTHZ_LEVEL = 0x00000010,

        /// <summary>
        /// LOAD_LIBRARY_AS_DATAFILE
        /// </summary>
        LOAD_LIBRARY_AS_DATAFILE = 0x00000002,

        /// <summary>
        /// LOAD_LIBRARY_AS_DATAFILE_EXCLUSIVE
        /// </summary>
        LOAD_LIBRARY_AS_DATAFILE_EXCLUSIVE = 0x00000040,

        /// <summary>
        /// LOAD_LIBRARY_AS_IMAGE_RESOURCE
        /// </summary>
        LOAD_LIBRARY_AS_IMAGE_RESOURCE = 0x00000020,

        /// <summary>
        /// LOAD_LIBRARY_SEARCH_APPLICATION_DIR
        /// </summary>
        LOAD_LIBRARY_SEARCH_APPLICATION_DIR = 0x00000200,

        /// <summary>
        /// LOAD_LIBRARY_SEARCH_DEFAULT_DIRS
        /// </summary>
        LOAD_LIBRARY_SEARCH_DEFAULT_DIRS = 0x00001000,

        /// <summary>
        /// LOAD_LIBRARY_SEARCH_DLL_LOAD_DIR
        /// </summary>
        LOAD_LIBRARY_SEARCH_DLL_LOAD_DIR = 0x00000100,

        /// <summary>
        /// LOAD_LIBRARY_SEARCH_SYSTEM32
        /// </summary>
        LOAD_LIBRARY_SEARCH_SYSTEM32 = 0x00000800,

        /// <summary>
        /// LOAD_LIBRARY_SEARCH_USER_DIRS
        /// </summary>
        LOAD_LIBRARY_SEARCH_USER_DIRS = 0x00000400,

        /// <summary>
        /// LOAD_WITH_ALTERED_SEARCH_PATH
        /// </summary>
        LOAD_WITH_ALTERED_SEARCH_PATH = 0x00000008
    }
}

使用DLLWrapper类动态读取C++Dll，获得函数指针，并且将指针封装成C#中的委托。原因很简单，C#中已经不能使用指针了，如下：
定义委托

UnmanagedFunctionPointer(CallingConvention.StdCall, CharSet = CharSet.Ansi)]
public delegate int Delegate_IKUSBSDK_GetVersion([In] [Out] [MarshalAs(UnmanagedType.LPArray)] byte[] version);

调用函数

//1. 加载sdk
var sdkModule = DLLWrapper.LoadSDK(_route.DeviceA_PATH);

// 2. 通过handle 找到相关的函数
Delegate_IKUSBSDK_GetVersion getVersion = (Delegate_IKUSBSDK_GetVersion)DLLWrapper.GetFunctionAddress(sdkModule, "IKUSBSDK_GetVersion", typeof(Delegate_IKUSBSDK_GetVersion));

var result = getVersion(version);

爱喝奶茶的火锅

关注

4
点赞
踩
33

收藏

觉得还不错? 一键收藏
0
评论
C#调用C++动态链接库dll

C#调用C++动态链接库dll由于公司很多底层的SDK，都是C++开发，上层的应用软件却是C# Winform程序。在实际工作的过程中，就经常碰到了C# 程序调用C++ 动态库的问题。最近一直在和C++ 打交道，C# 怎么调用C++ 类库函数。也遇到了一些问题，所以就来总结总结C#程序调用C++动态库时的各种坑。1. 可能遇到的问题： C#在调用动态库的过程中我也遇到了以下一些问题：...
复制链接

扫一扫