acltdtGetBufDataLen
acltdtGetBufUserData
函数功能
获取共享Buffer的私有数据区数据,偏移offset后并拷贝至用户申请的内存区域。同步接口。
约束说明
当前默认私有数据区大小是96Byte,offset+size必须小于或等于96Byte,否则返回报错。
仅支持在Control CPU开放形态或RC模式下使用该接口。
函数原型
aclError acltdtGetBufUserData (const acltdtBuf buf, void *dataPtr, size_t size, size_t offset)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| buf | 输入 | 共享Buffer指针,须通过acltdtAllocBuf或acltdtCopyBufRef接口申请获得。 |
| dataPtr | 输入 | 存放用户数据的内存地址指针。 |
| size | 输入 | 用户数据的长度,单位为Byte。 数据长度小于或等于96Byte。 |
| offset | 输入 | 地址偏移,单位为Byte。 偏移量小于或等于96Byte。 |
返回值说明
返回0表示成功,返回其它值表示失败。
父主题: 共享Buffer管理
acltdtSetBufDataLen
设置共享Buffer中有效数据的长度。同步接口。
约束说明
- 接口调用顺序:调用acltdtAllocBuf或acltdtCopyBufRef接口申请到共享Buffer后,因此需由用户调用acltdtGetBufData接口获取共享Buffer的内存指针及长度后,再自行向内存中填充有效数据。
- 仅支持在Control CPU开放形态或RC模式下使用该接口。
函数原型
aclError acltdtSetBufDataLen(****acltdtBuf buf, size_t len)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| buf | 输入 | 共享Buffer指针,须通过acltdtAllocBuf或acltdtCopyBufRef接口申请获得。 |
| len | 输入 | 有效数据的长度,单位为Byte。 |
返回值说明
返回0表示成功,返回其它值表示失败。
参考资源
接口调用流程及示例,参见共享Buffer管理。
父主题: 共享Buffer管理
acltdtGetBufDataLen
获取共享Buffer中有效数据的长度。同步接口。
约束说明
通过acltdtSetBufDataLen接口设置共享Buffer中有效数据的长度后,可调用本接口获取有效数据的长度,否则,通过本接口获取到的长度为0。
仅支持在Control CPU开放形态或RC模式下使用该接口。
函数原型
aclError acltdtGetBufDataLen(const acltdtBuf buf, size_t *len)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| buf | 输入 | 共享Buffer指针,须通过acltdtAllocBuf或acltdtCopyBufRef接口申请获得。 |
| len | 输出 | 有效数据的长度,单位为Byte。 |
返回值说明
返回0表示成功,返回其它值表示失败。
父主题: 共享Buffer管理
acltdtCopyBufRef
对共享Buffer数据区的引用拷贝,创建并返回一个新的Buffer管理结构指向相同的数据区。同步接口。
约束说明
仅支持在Control CPU开放形态或RC模式下使用该接口。
函数原型
aclError acltdtCopyBufRef(const acltdtBuf buf, acltdtBuf *newBuf)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| buf | 输入 | 共享Buffer指针,须通过acltdtAllocBuf或acltdtCopyBufRef接口申请获得。 |
| newBuf | 输出 | 返回一个新的共享Buffer指针,指向相同的数据区。 |
返回值说明
返回0表示成功,返回其它值表示失败。
父主题: 共享Buffer管理
acltdtAppendBufChain
将某个共享Buffer挂接到headBuf指向的共享Buffer的尾部,headBuf指向的共享Buffer为共享Buffer链头部的第一个共享Buffer,可以是一个单独的共享Buffer(这相当于共享Buffer链只有一个节点)。同步接口。
约束说明
仅支持在Control CPU开放形态或RC模式下使用该接口。
共享Buffer链最大支持128个共享Buffer。
函数原型
aclError acltdtAppendBufChain(****acltdtBuf headBuf, acltdtBuf buf)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| headBuf | 输入 | 共享Buffer链头部的第一个共享Buffer的指针,须通过acltdtAllocBuf或acltdtCopyBufRef接口申请获得。 |
| buf | 输入 | 待Append的buf指针,须通过acltdtAllocBuf或acltdtCopyBufRef接口申请获得。 |
返回值说明
返回0表示成功,返回其它值表示失败。
父主题: 共享Buffer管理
acltdtGetBufChainNum
获取共享Buffer链中的共享Buffer数量。同步接口。
约束说明
仅支持在Control CPU开放形态或RC模式下使用该接口。
函数原型
aclError acltdtGetBufChainNum(const acltdtBuf headBuf, uint32_t* num)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| headBuf | 输入 | 共享Buffer链头部的第一个共享Buffer的指针,须通过acltdtAllocBuf或acltdtCopyBufRef接口申请获得。 |
| num | 输出 | 共享Buffer链中的共享Buffer数量。 |
返回值说明
返回0表示成功,返回其它值表示失败。
父主题: 共享Buffer管理
在线提单