OPNET Modeler网络建模与仿真 教学课件 作者 李馨 第6 10章 第7章.pptVIP

第7章 OPNET Moduler 核心函数 知识点： 　　核心函数简介 　　基本核心函数本章导读：　　所谓核心函数，可能是在进程模型和收/发信机管道阶段中调用的函数，也可能是预设中断的C/C++函数，还可能是在上述某上下文中直接或间接调用的简单C/C++函数。核心函数按不同的功能划分为多个不同的函数集，同一函数集中的函数名称采用相同的函数集关键字。例如，绝大多数与数据包处理相关的核心函数都归入包函数集，采用“pk”关键字。　　本章将介绍核心函数的基本概念，并分类列举OPNET中常用的核心函数。 　　　　　　7.1 核心函数简介7.1.1 命名规则　　OPNET中的核心函数具有非常标准的命名规则，以增强函数在C/C++代码中的可视性，避免名称与非OPNET函数或变量冲突。以下列出了一些简单的命名规则：　　● 名称均采用op_作为前缀，以标识其为OPNET仿真内核提供的核心函数。　　● 函数名的第二部分为函数集名，用小写字母表示，通常是函数所处理对象的名称缩写，如pk、ici、stat等。 　　● 函数名的第三部分是子函数集名，对核心函数进一步进行了分类，如核心函数op_pk_nfd_set()中的nfd。　　● 核心函数主要用于对对象的操作。在函数名中，对象总是出现在动作之前，比如名称中的attr_set和subq_flush就将对象(attribute和subqueue)放在动作(set和flush)之前。 7.1.2 参数类型　　大部分核心函数的参数和返回值都是标准的C/C++数据类型，如int、double、char*。除此之外，在仿真数据结构中还通过C/C++的typedef语句定义了许多参数和返回值作为特殊的OPNET数据类型。尽管用户通过核心函数来操作OPNET数据类型，可能对每个数据类型的基本内容都越来越熟悉，但用户并不需要关心数据类型确切的内部结构，因为OPNET仿真数据结构的内容因软件版本的不同而有所改变。表7-1列举了部分特殊的数据类型。 表7-1 OPNET中部分特殊数据类型 　　1. ?Animation Entity　　动画集由操作中特定动画实体的ID号表示。之所以采用ID号来代替C/C++中的指针，是因为对于动画观察函数op_vuanim，ID号通信超过了仿真范围。尽管ID号只是存储在规则的C/C++整型变量中的简单整数值，但OPNET也声明了特定的数据类型来准确标记ID参数和变量。三种基于ID号的动画实体包括浏览器(Viewer)、宏(Macro)和图画(Drawing)。　　2. ?Boolean　　核心函数通过返回布尔值来表示结果是否正确。布尔值可与符号常量OPC_TRUE和OPC_FALSE进行比较。 　　3. ?Compcode　　核心函数通过返回Compcode值来表示操作是否正确完成。Compcode的值可与符号常量OPC_COMPCODE_SUCCESS和OPC_COMPCODE_FAILURE进行比较。　　4. ?Distribution　　Distribution是一种与概率密度函数(PDF)一致的数据结构，它描述了随机数到特定数字输出的映射。Distribution包含一张对映射进行编码的数字表，指出完成该映射的算法。对于基于表格的Distribution，数据从PDF编辑器的PDF模型文件中读入。这些结构均由Dist函数集中核心函数操作。 　　5. ?Event Handle　　事件句柄是惟一一种确定未决仿真事件(中断)的数据结构。该结构主要在Intrpt核心函数集中使用，因此可通过它们处理预设的中断。注意，事件句柄是一种数据结构，而不是整型或指针，因此不能把它存储在整型或指针变量中。 　　6. ?Statistic Handle　　统计量句柄是一种确定动态产生的全局和局部统计量的数据结构。统计量句柄的数据类型为Stathandle，获得该句柄的惟一方法是通过核心函数的Stat函数集来注册统计量。注册统计量时将为其指定一个惟一的名称，并和时间一起存储在一个输出矢量中。局部统计量用在特定处理器或队列中；全局统计量由仿真模型中的实体共享，每个实体分布式地作用于输出矢量。 　　7. ?ICI　　ICI(Interface Control Information，接口控制信息)是与仿真中断相关的结构化数据的集合，用于进程间通信机制，传输分层协议接口的控制信息。ICI由Ici函数集中的核心函数操作。　　8. ?List　　List是存储在双向链表中的数据元素的集合。List中的元素可按照从简单的C/C++数据类型到复杂的数据结构进行排列。List常用于临时存储数据结构组，可包含各种不同类型的元素，但通常并不这样使用。对List的大小