OPNET Modeler核心函数1. 核心函数简介1.1 命名规则OPNET中的核心函数具有非常标准的命名规则，以增强函数在C/C++代码中的可视性，避免名称与非OPNET函或变量冲突。

以下列出了一些简单的命名规则：●名称均采用op_作为前缀，以标识其为OPNET仿真核提供的核心函数。

●函数名的第二部分为函数集名，用小写字母表示，通常是函数所处理对象的名称缩写，如pk、ici、stat等。

●函数名的第三部分是子函数集名，对核心函数进一步进行了分类，如核心函数op_pk_nfd_set()中的nfd。

●核心函数主要用于对对象的操作。

在函数名中，对象总是出现在动作之前，比如名称中的attr_set和subq_flush就将对象（attribute和subqueue）放在动作（set和flush）之前。

1.2 参数类型大部分核心函数的参数和返回值都是标准的C/C++数据类型，如int、double、char*。

除此之外，在仿真数据结构中还通过C/C++的typedef语句定义了许多参数和返回值作为特殊的OPNET数据类型。

尽管用户通过核心函数来操作OPNET数据类型，可能对每个数据类型的基本容都越来越熟悉，但用户并不需要关心数据类型确切的部结构，因为OPNET仿真数据结构的容因软件版本的不同而有所改变。

表1-1列举了部分特殊的数据类型。

1. Animation Entity动画集由操作中特定动画实体的ID号表示。

之所以采用ID号来代替中的指针，是因为对于动画观察函数op_vuanim，ID号通信超过了了仿真围。

尽管ID号只是存储在规则的C/C++整型变量中的简单整数值，但OPNET也声明了特定的数据类型来准确标记ID参数和变量。

三种基于ID号的动画实体包括浏览器（Viewer）、宏（Macro）和图画（Drawing）。

2. Boolean核心函数通过返回布尔值来表示结果是否正确。

布尔值可与符号常量OPC_TRUE和OPC_FALSE进行比较。

3. Compcode核心函数通过返回Compcode值来表示操作是否正确完成。

Compcode的值可与符号常量OPC_COMPCOED_SUCCESS和OPC_COMPCOED_FAILURE进行比较。

4. DistributionDistribution是一种与概率密度函数（PDF）一致的数据结构，它描述了随机数到特定数字输出的映射。

Distribution包含一对映射进行编码的数字表，指出完成该映射的算法。

对于基于表格的Distribution，数据从PDF编辑器的PDF模型文件中读入。

这些结构均由Dist函数集中核心函数操作。

5. Event Handle事件句柄是惟一一种确定未决仿真事件（中断）的数据结构。

该结构主要在Intrpt核心函数集中使用，因此可通过它们处理预设的中断。

注意，事件句柄是一种数据结构，而不是整型或指针。

因此不能把它存储在整型或指针变量中。

6. Statistic Handle统计量句柄是一种确定动态产生的全局和局部统计量的数据结构。

统计量句柄的数据类型为Stathandle，获得盲文句柄的惟一方法是通过核心函数的Stat函数集来注册统计量。

注册统计量时将为其指定一个惟一的名称，并和时间一起存储在一个输出矢量中。

局部统计量用在特定处理器或队列中；全局统计量由仿真模型中的实体共享，每个实体分布式地作用于输出矢量。

7. ICIICI（Interface Control Information，接口控制信息）是与仿真中断相关的结构化数据的集合用于进程间通信机制，传输分层协议接口的控制信息。

ICI由Ici函数集中的杧函数操作。

8. ListList是存储在双向链表中的数据元素的集合。

List中的元素可按照从简单的C/C++数据类型在复杂的数据结构进行排列。

List学用于临时存储数据结构组，可包含各种不同类型的元素，但通常并不这样使用。

对List的大小没有限制，可在其任意位置插入或移除元素。

List由Prg函数集的List子函数集操作。

9. Object ID对像ID惟一地确定了一个仿真对象。

通过使用Objid数据类型声明该标识符，供Id、Ima、Topo和Pk函数集使用。

10. PacketPacket是数据封装和传输建模中的基本仿真实体。

它由Pk函数集中的核心函数操作。

11. Memory Object Type某些建模需要为其动态分配存来存储各种信息。

每个相同大小数据组成的集合记为一个池，核为每个池分配大量的数据条目以提高标准存分配器的效率。

每个汇聚池中的存对象必须通过调用核心函数op_prg_pmo_define()来创建，该函数将返回一个汇聚存对象句柄来标识池，用Pmohandle表示。

创建汇聚存对象时都为其分配了一个惟一的名称，仿真模型中的实体可以共享汇聚存对象。

12. Log Handle当在仿真调试或数据分析中创建仿真日志时，日志句柄对于每个日志项非常必要。

13. Procedure某些核心函数将C/C++函数指针作为参数，但并不声明这些参数作为指向返回整型值的函数的指针，而是定义了一种特殊的数据类型——Procedure。

14. Process Handle进程句柄是惟一一种标识仿真中活动进程的数据结构，由Pro函数集中的核心函数使用。

需注意进程免柄是数据结构，而不是整形或指针，因而不能将它们存储在整型或指针变量中。

15. Sar Buffer HandleSar缓冲句柄是惟一一种标识Sar（Segmentation & Reassembly，分段与重组）缓冲区的数据结构。

Sar缓冲区缓存包序列，并可对包进行分段和重装。

Sar缓冲区由Sar函数集中的核心函数创建，该函数返回访问新缓冲区的Sar缓冲句柄。

Sar函数集函数利用Sar缓冲名柄来处理被标识的Sar缓冲区。

与其他OPNET数据结构一样，不能将Sar缓冲句柄分配到整型或指针变量中。

16. Vartype除标准的C/C++数据类型和特殊的仿真核数据类型外，OPNET还提供了另外一种数据类型——Vartype。

Vartype数据类型可用在变量声明或类型转换语句中，它是OPNET文档中的特殊关键词，表示函数参数可以是多种可能的数据类型之一。

类型参数的传递由C描述的调用函数确定，Vartype用于确定哪个函数参数可用来传递多种数据类型。

但需要注意的是，Vartype 并不像C中的varargs那样可传递多种参数，每个Vartype参数一次只能接受一个传递值。

Vartype类型的参数，可接受int、double或指向数据结构的指针。

Vartype*是Vartype 的一种变体，它可接受指向变量类型的指针。

Vartype*类型的参数可接受的值包括：指向整型的指针、指向double的指针、指向数据结构的指针，或参数用于返回filled-in值时指向数据结构指针的指针。

每个核心函数中都描述了可被Vartype或Vartype*参数接受的类型值。

具有该类型参数的部分核心函数如表1-2所示。

返回变量类型参数的部分核心函数如表1-3所示。

1.3 多线程安全无线模块允许OPNET采用多处理器进行收/发信机管道计算。

为确保并行传输的正确性和尽可能快速，五个管道阶段必须采用多线程安全核心函数。

核心函数定义了三个多线程安全级别，分别是MT-safe、MT-unsafe和Forced serialization。

（1）MT-safe：该类核心函数已手动进行重编码以支持多线程。

多个线程可安全地并行执行该类核心函数。

（2）MT-unsafe：在该安全级别下，若在核心函数中采用并行处理，将导致性能的下降，达不到预期的结果。

使用MT-unsafe核心函数时，应当执行适当的代码序列化（Serialization）。

（3）Forced serialization：对于所有已手动重编码以支持多线程的核心函数，仿真核采用部互斥来执行严格的序列化。

最终每个核心函数将进行手动重编码来支持多线程，它们的状态也将由Forced serialization变为MT-safe。

2. 基本核心函数OPNET Modeler10.0提供了21个核心函数集，只有熟悉核心函数才能在建模时方便地进行代码编写。

本节按照不同的功能对常用的核心函数作了详细的介绍。

2.1 部模型访问函数集Ima（Internal Model Access，部模型访问）函数集是一系列提供对仿真实体动态访问的核心函数的集合，其中仿真实体包括仿真属性、对象属性、对象命令（Object Command）和进程状态变量。

1. op_ima_obj_attr_get (objid,attr_name,value_ptr)此核心函数的作用是获取给定对象的某属性值，其参数说明如表2-1所示。

表2-1 op_ima_obj_attr_get()函数的参数说明1）返回值Compcode——如果成功获取属性值，即返回OPC_COMPCODE_SUCCESS，否则返回OPC_COMPCODE_FAILURE。

如果需要获取给定对象的复合属性值，则若复合属性相等，value_ptr的值即设为复合属性中的一个对象ID，并返回OPC_COMPCODE_SUCCESS；若不相等，则返回OPC_COMPCODE_FAILURE。

注意：在复合属性中，所谓的“相等”，是指复合属性中的所有属性都具有相同的名称、类型和值，并且复合忏悔的所有子对象也相等。

2）详解对于网络域对象（子网、节点和链路）、节点域对象（模块）以及预先由网络、节点、进程或链路编辑器定义的复合属性，都可以获取对象属性值。

提升的属性值可以从父对象中获取。

要引用提升属性，必须为每个中间对象的属性名附加一个点分前缀。

例如，若要在节点级获取进程属性，则属性名应在包含该进程的模块名称之前。

并不是所有的对象属性都可仿真中调用该函数来获取。

比如Simulation/Access字段被标记为N/A的属性就不能通过调用op_ima_obj_attr_get()来获取。

此外，该核心函数的命令级别为Forced serialization。

3）目的该函数提供了一种在仿真中动态获取对象属性的机制。

它可用于处理器或队列确定自身或网络中其他对象的属性值。

将该函数与op_ima_obj_attr_set()结合，无需包、ICI或中断递送就可提供远程进程间的通信。

4）错误Program Abort：分段错误（由无效值指针、指针所指存不足或指向无效的attr_name地址所引起）。

Recoverable Error：对象无法识别属性名。

Recoverable Error：对象ID溢出。

Recoverable Error：对象ID指向受限对象（由受护模型中的相关对象引起）。