You need to enable JavaScript to run this app. 使用UnmanagedCallersOnly时如何正确建模含定长字符串字段的结构体
优惠活动
大模型
产品
解决方案
定价
更多

使用UnmanagedCallersOnly时如何正确建模含定长字符串字段的结构体

核心报错原因

触发"Cannot use 'PluginInfo' as a parameter type on a method attributed with 'UnmanagedCallersOnly'"错误的本质是:UnmanagedCallersOnly标记的方法,所有入参必须是纯非托管blittable类型——也就是没有任何托管引用、不需要运行时动态封送、内存布局和非托管侧完全一致的值类型。你当前的结构体定义存在三个核心问题:

  • 字段使用了托管的string类型搭配封送特性,string是引用类型,会让整个结构体被判定为含托管成员的非blittable类型,完全不满足参数校验要求
  • 封送特性选型错误:UnmanagedType.LPWStr对应的是非托管侧的字符串指针(wchar_t*),而你对接的C++字段是内联在结构体里的定长字符数组(char szName[64]),内存布局完全不匹配,即使不考虑UnmanagedCallersOnly的要求,跨边界传递也会出现内存错乱
  • 字符集设置错误:C++原生char是单字节ANSI编码,你设置的CharSet.Unicode会导致字符串编解码完全错位
适配UnmanagedCallersOnly的正确结构体建模

要让结构体满足要求,必须完全去掉托管引用类型,用纯非托管的固定缓冲区对应C++的定长字符数组,让整个结构体成为无任何封送逻辑的纯blittable类型:

  • 首先需要在项目配置中启用AllowUnsafeBlocks,因为需要使用固定大小的内存缓冲区
  • 所有字符串字段替换为定长的byte固定缓冲区,匹配C++侧单字节char的内存布局
  • 枚举字段只要和C++侧的基础类型(4字节int)匹配,不需要额外封送标记,本身就是blittable类型

修正后的完整代码

// 项目需启用 <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Ansi)]
public unsafe struct PluginInfo
{
    public int StructSize;
    // 枚举 underlying 为int时本身是blittable类型,无需额外MarshalAs
    public PluginType Type;
    public int Version;
    // 直接内联64字节的缓冲区,完全匹配C++侧 char szName[64] 的内存布局
    public fixed byte szName[64];
    public fixed byte szVendor[64];
}

// 提供轻量的字符串读写辅助,避免手动转字节数组
public static class PluginInfoExtensions
{
    public static string ReadName(this ref PluginInfo info)
    {
        return Marshal.PtrToStringAnsi((IntPtr)info.szName, 64);
    }

    public static void WriteName(this ref PluginInfo info, string content)
    {
        // 截断超长内容,留1个字节给字符串终止符
        var validContent = content.Length > 63 ? content[..63] : content;
        var bytes = Encoding.Default.GetBytes(validContent + "\0");
        Marshal.Copy(bytes, 0, (IntPtr)info.szName, bytes.Length);
    }

    public static string ReadVendor(this ref PluginInfo info)
    {
        return Marshal.PtrToStringAnsi((IntPtr)info.szVendor, 64);
    }

    public static void WriteVendor(this ref PluginInfo info, string content)
    {
        var validContent = content.Length > 63 ? content[..63] : content;
        var bytes = Encoding.Default.GetBytes(validContent + "\0");
        Marshal.Copy(bytes, 0, (IntPtr)info.szVendor, bytes.Length);
    }
}

public class Plugin
{
    [UnmanagedCallersOnly(CallConvs = new[] { typeof(CallConvCdecl) })]
    public static void GetPluginInfo(ref PluginInfo pluginInfo)
    {
        // 纯blittable结构体可直接用sizeof计算实际大小,无需Marshal.SizeOf
        pluginInfo.StructSize = sizeof(PluginInfo);
        pluginInfo.Type = PluginType.Data;
        pluginInfo.WriteName("myPluginName");
        pluginInfo.WriteVendor("myVendorName");
    }
}
关键注意事项
  • 为什么不能用传统的[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 64)]搭配string的写法?这种写法依赖运行时的封送器在托管和非托管内存之间动态拷贝字符串,属于非blittable逻辑,带这种标记的结构体仍然无法通过UnmanagedCallersOnly的参数校验
  • 为什么不能用byte[]搭配[MarshalAs(UnmanagedType.ByValArray, SizeConst =64)]的写法?C#中的数组是托管引用类型,即使标记了ByValArray,仍然需要运行时封送拷贝,不属于纯blittable类型,同样不满足参数要求
  • 改造后的结构体内存布局和C++侧完全1:1匹配,跨边界传递时不需要任何额外封送开销,也完全符合UnmanagedCallersOnly的类型要求

内容的提问来源于stack exchange,提问作者Ceres

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 04:06:09