C++联合体映射为C#结构体的实现方法

问题背景与解决思路

C++中的联合体允许不同成员变量共享同一段内存空间，这在多媒体数据（如音视频混合帧）处理中非常常见。然而，C#是强类型语言且默认不支持直接映射未标记的C++联合。当项目需要接收并解析来自C++层解码后的帧数据时，必须建立准确的内存映射关系。

核心解决方案是利用C#提供的互操作服务，指定结构的物理存储方式，手动构建一个与C++内存布局完全一致的扁平化结构体。

实现步骤

第一步：引入必要的命名空间

为了定义自定义内存布局，必须在代码文件头部引入以下标准库：

using System.Runtime.InteropServices;

这是使用[StructLayout]属性的前提条件。

第二步：定义基础数据结构原型

在C++端，典型的帧信息结构包含媒体类型、时间戳以及用于音视频切换的联合体。其逻辑模型如下：

// C++ 原型参考
typedef struct tagTFrameInfo {
    BYTE   m_byMediaType; // 媒体类型
    DWORD  m_dwTimeStamp; // 时间戳
    union { /* YUV参数 */ }; 
    union { /* 其他参数 */ };
} TFrameInfo;

由于C#无法直接识别union关键字的内存重叠行为，我们需要将这些共享内存的字段“拆解”为独立的成员变量。

第三步：构建C#映射结构体

使用[StructLayout(LayoutKind.Sequential)]强制编译器按代码声明的顺序分配内存，严禁使用默认的Pack或Explicit模式以免导致偏移量错误。

[StructLayout(LayoutKind.Sequential)]
public struct tagTFrameInfo_YUV420
{
    /// <summary>
    /// 对应 C++: BYTE m_byMediaType
    /// 含义：媒体类型 (0:YUV420, 1:PCM, 2:RGB32等)
    /// </summary>
    public byte m_byMediaType;

    /// <summary>
    /// 对应 C++: DWORD m_dwTimeStamp
    /// 含义：帧的时间戳
    /// </summary>
    public UInt32 m_dwTimeStamp;

    /// <summary>
    /// 对应联合体字段1: BYTE m_byBitCount (YUV色深) 或 m_bStereo (PCM声道)
    /// 注意：这两个值在内存中占据同一个字节位置
    /// </summary>
    public byte m_byBitCount;

    /// <summary>
    /// 对应联合体字段2: WORD m_wVideoWidth (视频宽) 或 m_wBitRate (采样率)
    /// 注意：占用接下来的两个字节
    /// </summary>
    public UInt16 m_wVideoWidth;

    /// <summary>
    /// 对应联合体字段3: WORD m_wVideoHeight (视频高) 或 m_wBand (采样位数)
    /// 注意：占用随后的两个字节
    /// </summary>
    public UInt16 m_wVideoHeight;
}

第四步：注意事项与内存对齐

• 类型对应：BYTE映射为byte，WORD映射为UInt16，DWORD映射为UInt32。务必保证大小写和符号一致。
• 字段顺序：C++联合体中的重叠字段，在C#中只需按其在原结构中出现的首个有效位置放置一次即可（或者根据实际需求保留多个只读占位符），因为它们在底层共享相同的offset。
• 调试建议：在使用前，建议在C#中使用Marshal.SizeOf<tagTFrameInfo_YUV420>()计算结构体大小，确认其与C++端的sizeof(TFrameInfo)完全相等。

完成判断

编写完成后，可以通过创建一个实例并赋值检查各字段的基址是否连续，且覆盖区域是否正确反映了联合体特征。若后续涉及跨平台调用，建议结合MarshalAs进一步固定字符串或数组的长度。

以上就是C++联合体转换成C#结构的详细内容，更多关于C#结构体映射的资料请关注本站其它相关文章！