op_apptrack_pk_tag()
摘要
为数据包打上应用延迟跟踪标记。
语法
op_apptrack_pk_tag (apptrack_hndl, pkptr, app_instance_id)
| 参数 | 类型 | 说明 |
|---|---|---|
apptrack_hndl |
Apptrackhandle |
所关注的 ADT 状态。 |
pkptr |
SimT_Packet * |
所关注的数据包。 |
app_instance_id |
OpT_uInt32 |
被跟踪的实例(不得已完成)。 |
返回类型
Compcode
若该内核过程成功完成则返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。
详情
无。
用途
该内核过程注册一条应用消息,并将该消息标记到数据包上,使数据包在仿真期间可沿网络被跟踪。
错误
- 可恢复错误:参数 (
apptrack_hndl) 为 NIL。 - 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针指向已销毁的数据包。
- 程序中止:数据包指针指向无主数据包 (
<packet ID>)。 - 程序中止:数据包指针指向静态数据包 (
<packet ID>)。 - 可恢复错误:应用实例 (
<instance_id>) 无效或已完成。
参考
- 使用内核过程 op_apptrack_instance_create() 获取用于跟踪的 ID。
- 必要时使用内核过程 op_apptrack_pk_tag_clear() 移除标记。