op_pk_transfer()
摘要
用一个数据包的内容替换另一个数据包的内容。
语法
op_pk_transfer (from_pkptr, to_pkptr)
| 参数 | 类型 | 说明 |
|---|---|---|
from_pkptr |
Packet * |
传输的源数据包。 |
to_pkptr |
Packet * |
传输的目标数据包。 |
返回类型
void
无返回值。
示例
/* receive a frame from upper layer */
ul_pkptr = op_pk_get (0);
/* transfer contents to messenger packet and send onward */
op_pk_transfer (ul_pkptr, msg_pkptr);
op_pk_send (msg_pkptr, 1);
详情
传输之前,to_pkptr 中包含的任何对象都会被释放。to_pkptr 中会保留以下一些信息字段:
- 创建时间
- 创建模块的对象 ID
- 数据包拥有者
- 数据包 ID
用途
提供了一种将数据包克隆到另一个已存在数据包中的方法。此函数比逐字段复制数据包更快,当代码不了解源数据包格式的详细信息时尤其有用。
错误
- 程序中止:数据包指针指向未被拥有的数据包(
<pk_id>)。 - 程序中止:段违例。(由于无效的数据包指针、格式错误的数据包,或数据包内格式错误的结构或数据包字段)
参考
- 使用内核过程 op_pk_copy() 将数据包克隆到一个新创建的数据包