如何在C#中封装带指针参数的C++ DLL？调用遇阻求指引

我之前处理过不少C#和C++互操作的场景，咱们一步步拆解这个问题，帮你搞定指针参数的处理。

第一步：先明确C++目标函数的完整签名 #

你只给出了枚举和导出宏，得先把要调用的函数完整签名列出来才行。我先拿一个常见的场景举例，比如有这么个函数：

STCL_DEVICES_EXPORT SD_ERR GetDeviceInfo(int deviceIndex, char* deviceName, int* nameLength);

你可以把这个例子替换成你实际要调用的函数。

第二步：在C#中做对应声明 #

在C#里，我们用[DllImport]特性导入DLL，同时针对不同类型的指针做适配：

1. 处理字符串指针（char*） #

如果是C++里的输出型字符串指针，C#里用StringBuilder来对应最稳妥——它是可变的，能接收DLL返回的字符串内容：

// 先把C++的枚举映射到C#
public enum SD_ERR
{
    SD_ERR_OK = 0,
    SD_ERR_FAIL,
    SD_ERR_DLL_NOT_OPEN,
    SD_ERR_INVALID_DEVICE
}

// 导入DLL函数，注意指定调用约定！
[DllImport("你的DLL文件名.dll", CallingConvention = CallingConvention.Cdecl)]
public static extern SD_ERR GetDeviceInfo(int deviceIndex, StringBuilder deviceName, ref int nameLength);

这里要注意两个关键点：

• 必须指定调用约定：C++默认是cdecl，C#默认是StdCall，不匹配会直接导致栈溢出崩溃
• 对于输出型的int*，用C#的ref int对应，它会传递变量的内存地址

2. 处理自定义结构体指针 #

如果是C里的自定义结构体指针，先在C#里定义完全匹配的结构体，用[StructLayout(LayoutKind.Sequential)]保证内存布局和C一致：

// C++侧的结构体
typedef struct {
    int deviceId;
    float currentValue;
} DeviceStatus;

STCL_DEVICES_EXPORT SD_ERR GetDeviceStatus(int deviceIndex, DeviceStatus* status);

对应的C#代码：

[StructLayout(LayoutKind.Sequential)]
public struct DeviceStatus
{
    public int deviceId;
    public float currentValue;
}

[DllImport("你的DLL文件名.dll", CallingConvention = CallingConvention.Cdecl)]
public static extern SD_ERR GetDeviceStatus(int deviceIndex, ref DeviceStatus status);

3. 处理通用指针（void*） #

如果是C++里的void*这种通用指针，C#里用IntPtr来对应，需要读写数据时用Marshal类做转换：

STCL_DEVICES_EXPORT SD_ERR ReadRawData(int deviceIndex, void* buffer, int bufferSize);

C#声明和调用：

[DllImport("你的DLL文件名.dll", CallingConvention = CallingConvention.Cdecl)]
public static extern SD_ERR ReadRawData(int deviceIndex, IntPtr buffer, int bufferSize);

// 调用示例：分配内存并读取数据
int bufferSize = 1024;
IntPtr buffer = Marshal.AllocHGlobal(bufferSize);
SD_ERR result = ReadRawData(0, buffer, bufferSize);
// 读取数据到byte数组
byte[] data = new byte[bufferSize];
Marshal.Copy(buffer, data, 0, bufferSize);
// 用完记得释放内存
Marshal.FreeHGlobal(buffer);

第三步：调用时的关键细节 #

• 用StringBuilder接收字符串时，必须提前初始化足够的容量：

int nameMaxLen = 256;
StringBuilder deviceName = new StringBuilder(nameMaxLen);
SD_ERR result = GetDeviceInfo(0, deviceName, ref nameMaxLen);
if (result == SD_ERR.SD_ERR_OK)
{
    Console.WriteLine($"设备名称：{deviceName.ToString()}");
}

• 如果是C++里的输入型const char*指针，C#直接传string就行，CLR会自动做编码转换：

STCL_DEVICES_EXPORT SD_ERR SetDeviceName(int deviceIndex, const char* newName);

C#声明：

[DllImport("你的DLL文件名.dll", CallingConvention = CallingConvention.Cdecl)]
public static extern SD_ERR SetDeviceName(int deviceIndex, string newName);

常见踩坑点 #

• 调用约定不匹配：一定要确认C++函数的调用约定，除了cdecl，还有可能是stdcall，如果DLL里用了_stdcall，C#里要改成CallingConvention.StdCall
• 结构体内存布局不一致：C++里的unsigned int对应C#的uint，double对应double，字段顺序必须完全一致，不能乱
• 字符串编码问题：如果C++用的是宽字符（wchar_t*），C#里要加CharSet = CharSet.Unicode：

[DllImport("你的DLL文件名.dll", CallingConvention = CallingConvention.Cdecl, CharSet = CharSet.Unicode)]
public static extern SD_ERR GetDeviceNameW(int deviceIndex, StringBuilder deviceName, ref int nameLength);

如果你能把具体的目标函数签名贴出来，我可以给你更精准的代码示例。

内容的提问来源于stack exchange，提问作者salocinx