参数数据类型

KP 描述中的语法与返回类型小节给出 KP 的调用语法。过程的每个参数都单独列出,同时也给出过程的返回类型。参数列表包含名称、C/C++ 数据类型和说明文字;返回类型的形式与之类似,只是没有名称。这两个小节的目的是清晰定义 KP 的调用接口,并避免对返回值或参数数据类型的错误解读。

许多 KP 的参数和返回值是标准 C/C++ 数据类型,例如 int、double 和 char*。

除基本 C/C++ 数据类型外,参数和返回值通常被声明为特殊的 Riverbed 数据类型。这些数据类型通过 C/C++ 语言的 typedef 语句由仿真数据结构派生而来。虽然用户经由 KP 操作 Riverbed 数据类型,并会逐渐熟悉每种数据类型的基本内容,但无需关心数据类型的确切内部结构。事实上,仿真数据结构的内容可能在新版软件中发生变化,因此不依赖数据结构中未加文档说明的内部字段是一种良好的实践。以下小节将逐一介绍这些特殊数据类型。

动画实体

Anim(动画)包依赖数字“序列号”(ID)来指代参与操作的特定动画实体。使用整数 ID 而非 C/C++ 指针,是因为这些 ID 需要在仿真范围之外传递,传送给动画查看器程序 op_vuanim。尽管这些 ID 只是整数值、可以存放在普通的 C/C++ 整数变量中,但仍声明了专门的数据类型,以便精确标识 ID 参数和变量。ID 所引用的三种动画实体是查看器、宏和绘图;它们各自的数据类型列举如下。

基础数据类型 Anvid(查看器 ID)
示例声明 Anvid vid;
基础数据类型 Anmid(宏 ID)
示例声明 Anmid mid;
基础数据类型 Andid(绘图 ID)
示例声明 Andid did;

布尔值

布尔值是许多内核过程返回的值,用于指示真或假的结果。布尔值可以与符号常量 OPC_TRUE 和 OPC_FALSE 进行比较。

基础数据类型 Boolean
示例声明 Boolean bool;

完成代码

完成代码是许多内核过程返回的值,用于指示操作是否成功完成。Compcode 的值可以与符号常量 OPC_COMPCODE_SUCCESS 和 OPC_COMPCODE_FAILURE 进行比较。

基础数据类型 Compcode
示例声明 Compcode comp_status;

分布

分布是描述将随机数映射为特定数值结果的数据结构,该映射与概率密度函数(PDF)一致。分布可以包含编码此映射的数值表,也可以指向一个执行映射的算法。对于基于表的分布,其内容数据从使用 PDF 编辑器准备的 PDF 模型文件中读入。这些结构由 Dist 包的 KP 操作。

基础数据类型 Distribution
示例声明 Distribution* dist_ptr;

事件句柄

事件句柄是唯一标识某个待处理仿真事件(中断)的数据结构。这些结构由 Intrpt 包的 KP 使用,从而可以通过句柄操作已调度的中断。注意,事件句柄实际上是数据结构,而不是整数或指针,因此不应将其强制转换或存放到整数或指针变量中。

基础数据类型 Evhandle
示例声明 Evhandle evh;

统计量句柄

统计量句柄是用于标识动态创建的全局和局部统计量的数据结构。为这些句柄提供的数据类型是 Stathandle,获取此类句柄的唯一途径是通过 Stat 包中专门用于此目的的 KP“注册”一个统计量。每个统计量在注册时指定一个唯一名称,并且有一个用于随时间存储其值的输出向量。局部统计量在特定的处理器或队列内使用。全局统计量通常由仿真模型中的多个不同实体共享,每个实体以分布式的方式对输出向量作出贡献。

基础数据类型 Stathandle
示例声明 Stathandle stat_handle;

ICIs

ICIs(接口控制信息)是与仿真中断关联的结构化数据集合。它们作为一种进程间通信机制,专门用于传递控制分层协议接口的信息。这些结构由 Ici 包的 KP 操作。

基础数据类型 Ici
示例声明 Ici* ici_ptr;

列表

列表是数据元素的有序集合,存储于双向链表中。列表中的元素可以是简单的 C/C++ 数据类型,也可以是复杂的数据结构。列表可以是异构的,包含各种不同元素的集合,但通常并非如此。列表可以任意增长;元素可以在任何指定位置插入或移除。列表常用于临时存储相关数据结构的组合。这些结构由 Prg 包的 List 子包操作。

基础数据类型 List
示例声明 List* list_ptr;

对象 ID

对象 ID 是唯一标识单个仿真对象的数字“序列号”。这些标识符使用 Objid 数据类型声明。Objid 由 Id、Ima、Topo 和 Pk 包使用。

基础数据类型 Objid
示例声明 Objid objid;

数据包

Packet(数据包)是用于建模数据封装与传输的基本仿真实体。这些结构由 Pk 包的 KP 操作。

基础数据类型 Packet
示例声明 Packet* pkptr;

内存对象类型

某些建模应用可能需要动态分配内存,以便为不定量的信息提供存储。当新的数据项被反复创建和销毁,且可以识别出物理尺寸(以字节计)相同的数据项分组时,使用仿真内核提供的 Pooled Memory(池化内存)设施通常是最高效的。每组尺寸相同的数据项称为一个池,内核能够为每个池同时分配大量数据项,从而比标准内存分配器更高效。每种池化内存对象类型都必须通过调用 KP op_prg_pmo_define() 来创建,该 KP 返回一个标识该池的 Pooled Memory Object Handle(池化内存对象句柄)。为这些句柄提供的数据类型是 Pmohandle。每种池化内存对象类型在创建时指定一个唯一名称。每种池化内存对象类型通常由仿真模型中的多个实体共享。

基础数据类型 Pmohandle
示例声明 Pmohandle pmh;

日志句柄

在创建仿真日志以辅助仿真调试或结果分析时,每一类日志条目都需要一个日志句柄。

基础数据类型 Log_Handle
示例声明 Log_Handle config_log_hndl;

过程

若干 KP 以 C/C++ 函数指针作为参数。这些参数不是声明为返回整数的函数指针,而是为声明定义了一个特殊的数据类型,称为 Procedure。

基础数据类型 Procedure
示例声明 Procedure proc;

进程句柄

进程句柄是唯一标识仿真中某个活动进程的数据结构。这些结构由 Pro 包的 KP 使用,从而可以对进程执行操作。进程句柄实际上是数据结构,而不是整数或指针,因此不应将其强制转换或存放到整数或指针变量中。

基础数据类型 Prohandle
示例声明 Prohandle proh;

SAR 缓冲区句柄

Sar 缓冲区句柄是唯一标识某个 Sar(Segmentation & Reassembly,分段与重组)缓冲区的数据结构;Sar 缓冲区是对数据包序列进行缓冲的对象,既可以把数据包拆分为分段,也可以把分段重组为数据包。Sar 缓冲区由 Sar 包中的一个 KP 创建,该 KP 返回一个 Sar 缓冲区句柄以访问新缓冲区。Sar 缓冲区句柄被传递给大多数 Sar 包的 KP,使这些 KP 能够在指定的 Sar 缓冲区上操作。与其他句柄数据结构一样,Sar 缓冲区句柄不应被强制转换或赋值给整数或指针。

基础数据类型 Sbhandle
示例声明 Sbhandle sbh;

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com