VmbFrameAnnounce的const结构体形参为何可被修改成员？

const声明的设计初衷与实际现状 #

• 函数签名中const VmbFrame_t* pFrame的初始设计意图，是向调用方传递明确语义：函数只会读取pFrame指向结构体的内容，不会修改结构体本身的成员。这个设计完全匹配旧版SDK的逻辑：用户自行分配图像缓冲区、填充buffer和bufferSize字段后传入，函数仅读取这些配置完成传输层DMA准备、帧注册操作，全程不改动传入的结构体。
• 你判断的向后兼容逻辑完全正确。后续SDK版本新增自动分配缓冲区功能时，为了不破坏已有的源码、二进制兼容性，避免旧代码因为函数签名变更无法编译/运行，没有修改原函数的形参声明，而是在内部实现中绕过const限制，在pFrame->buffer == NULL的场景下把SDK分配的缓冲区地址写回该成员。

C语言const约束的本质 #

• C语言中const T*类型的指针仅提供编译期的读写权限检查：它禁止通过这个指针直接修改指向的内存，但不会改变对应内存区域本身的可写属性，也不阻止通过强制类型转换、其他别名指针修改同一块内存。
• SDK内部实现修改buffer成员的逻辑和下面的示意代码基本一致：

// SDK内部实现逻辑片段
VmbError_t VMB_CALL VmbFrameAnnounce(const VmbHandle_t cameraHandle,
                                     const VmbFrame_t* pFrame,
                                     VmbUint32_t sizeofFrame)
{
    // 前置校验：句柄合法性、结构体大小、参数有效性
    if (pFrame->buffer == NULL) {
        // 按传入的bufferSize分配符合DMA要求的内存块
        void* sdkAllocatedBuf = transport_layer_alloc(pFrame->bufferSize);
        // 强制转换去掉const修饰，回写分配到的缓冲区地址
        ((VmbFrame_t*)pFrame)->buffer = sdkAllocatedBuf;
    }
    // 完成帧注册、DMA映射等后续操作
    return VmbErrorSuccess;
}

• 这种写法虽然从C语言标准角度属于未定义行为，但在实际工程中只要调用方传入的VmbFrame_t实例本身不是存储在只读段的const常量（日常开发中几乎都是栈、堆上分配的普通可写结构体），运行时不会出现问题，本质是库开发中为了兼容做的契约妥协。

帧注册与内存分配的正确使用方式 #

• 自行管理缓冲区场景
  1. 提前分配满足帧大小、对齐要求的内存，将地址赋值给VmbFrame_t.buffer，填写正确的bufferSize字段
  2. 调用VmbFrameAnnounce完成注册，该场景下传入的结构体不会被SDK修改
  3. 帧注销、采集停止后，需要用户手动释放之前自行分配的缓冲区内存
• SDK托管缓冲区场景
  1. 初始化VmbFrame_t结构体时将buffer设为NULL，填写正确的bufferSize字段
  2. 调用VmbFrameAnnounce，函数返回成功后buffer成员会被SDK写入自动分配的缓冲区地址
  3. 后续帧注销时SDK会自动回收这部分缓冲区内存，不需要用户手动释放

注意：禁止将定义为const VmbFrame_t类型的只读结构体实例传入该函数，否则SDK回写buffer字段时会触发内存访问异常。

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