OPNET_Modeler-core-function

1、OPNET Modeler核心函数42目录1. 核心函数简介31.1 命名规则31.2 参数类型31.2.1 Animation Entity41.2.2 Boolean41.2.3 Compcode41.2.4.Distribution41.2.5 Event Handle41.2.6 Statistic Handle41.2.7 ICI41.2.8 List51.2.9 Object ID51.2.10 Packet51.2.11 Memory Object Type51.2.12 Log Handle51.2.13 Procedure51.2.14 Process Handle51.2.

2、15 Sar Buffer Handle51.2.16 Vartype61.3 多线程安全72. 基本核心函数72.1 内部模型访问函数集72.2 分布函数集102.3 进程函数集122.4 事件函数集152.5 仿真函数集162.6 鉴定函数集172.7 拓扑函数集182.8 接口控制信息函数集232.9 中断函数集262.10 包函数集312.11 子队列函数集382.12 统计量函数集401. 核心函数简介1.1 命名规则OPNET中的核心函数具有非常标准的命名规则，以增强函数在C/C+代码中的可视性，避免名称与非OPNET函或变量冲突。以下列出了一些简单的命名规则：名称均采用op_作为

3、前缀，以标识其为OPNET仿真内核提供的核心函数。函数名的第二部分为函数集名，用小写字母表示，通常是函数所处理对象的名称缩写，如pk、ici、stat等。函数名的第三部分是子函数集名，对核心函数进一步进行了分类，如核心函数op_pk_nfd_set()中的nfd。核心函数主要用于对对象的操作。在函数名中，对象总是出现在动作之前，比如名称中的attr_set和subq_flush就将对象（attribute和subqueue）放在动作（set和flush）之前。1.2 参数类型大部分核心函数的参数和返回值都是标准的C/C+数据类型，如int、double、char*。除此之外，在仿真数据结构中还

4、通过C/C+的typedef语句定义了许多参数和返回值作为特殊的OPNET数据类型。尽管用户通过核心函数来操作OPNET数据类型，可能对每个数据类型的基本内容都越来越熟悉，但用户并不需要关心数据类型确切的内部结构，因为OPNET仿真数据结构的内容因软件版本的不同而有所改变。表1-1列举了部分特殊的数据类型。表1-1 OPNET中部分特殊数据类型基本数据类型声明示例Anvid (viewer ID)Anvid vid;Anmid (macro ID)Anmid mid;Andid (drawing ID)Andid did;BooleanBoolean bool;CompcodeCompcode

5、 comp_status;DistributionDistribution* dist_ptr;EvhandleEvhandle evh;StathandleStathandle Stat_handle;IciIci* ici_ptr;ListList* list_ptr;ObjidObjid objid;PacketPacket* pkptr;PmohandlePmohandle pmh;Log_HandleLog_Handle config_log_hndl;ProcedureProcedure proc;ProhandleProhandle proh;SbhandleSbhandle s

6、bh;1.2.1 Animation Entity动画集由操作中特定动画实体的ID号表示。之所以采用ID号来代替中的指针，是因为对于动画观察函数op_vuanim，ID号通信超过了仿真范围。尽管ID号只是存储在规则的C/C+整型变量中的简单整数值，但OPNET也声明了特定的数据类型来准确标记ID参数和变量。三种基于ID号的动画实体包括浏览器（Viewer）、宏（Macro）和图画（Drawing）。1.2.2 Boolean核心函数通过返回布尔值来表示结果是否正确。布尔值可与符号常量OPC_TRUE和OPC_FALSE进行比较。1.2.3 Compcode核心函数通过返回Compcode值来表

7、示操作是否正确完成。Compcode的值可与符号常量OPC_COMPCODE_SUCCESS和OPC_COMPCODE_FAILURE进行比较。1.2.4.DistributionDistribution是一种与概率密度函数（PDF）一致的数据结构，它描述了随机数到特定数字输出的映射。Distribution包含一张对映射进行编码的数字表，指出完成该映射的算法。对于基于表格的Distribution，数据从PDF编辑器的PDF模型文件中读入。这些结构均由Dist函数集中核心函数操作。1.2.5 Event Handle事件句柄是惟一一种确定未决仿真事件（中断）的数据结构。该结构主要在Intrp

8、t核心函数集中使用，因此可通过它们处理预设的中断。注意，事件句柄是一种数据结构，而不是整型或指针。因此不能把它存储在整型或指针变量中。1.2.6 Statistic Handle统计量句柄是一种确定动态产生的全局和局部统计量的数据结构。统计量句柄的数据类型为Stathandle，获得统计量句柄的惟一方法是通过核心函数的Stat函数集来注册统计量。注册统计量时将为其指定一个惟一的名称，并和时间一起存储在一个输出矢量中。局部统计量用在特定处理器或队列中；全局统计量由仿真模型中的实体共享，每个实体分布式地作用于输出矢量。1.2.7 ICIICI（Interface Control Informati

9、on，接口控制信息）是与仿真中断相关的结构化数据的集合用于进程间通信机制，传输分层协议接口的控制信息。ICI由ici函数集中的核心函数操作。1.2.8 ListList是存储在双向链表中的数据元素的集合。List中的元素可按照从简单的C/C+数据类型在复杂的数据结构进行排列。List主要用于临时存储数据结构组，可包含各种不同类型的元素，但通常并不这样使用。对List的大小没有限制，可在其任意位置插入或移除元素。List由Prg函数集的List子函数集操作。1.2.9 Object ID对像ID惟一地确定了一个仿真对象。通过使用Objid数据类型声明该标识符，供Id、Ima、Topo和Pk函数集

10、使用。1.2.10 PacketPacket是数据封装和传输建模中的基本仿真实体。它由Pk函数集中的核心函数操作。1.2.11 Memory Object Type某些建模需要为其动态分配内存来存储各种信息。每个相同大小数据组成的集合记为一个池，内核为每个池分配大量的数据条目以提高标准内存分配器的效率。每个汇聚池中的内存对象必须通过调用核心函数op_prg_pmo_define()来创建，该函数将返回一个汇聚内存对象句柄来标识池，用Pmohandle表示。创建汇聚内存对象时都为其分配了一个惟一的名称，仿真模型中的实体可以共享汇聚内存对象。1.2.12 Log Handle当在仿真调试或数据分析

11、中创建仿真日志时，日志句柄对于每个日志项非常必要。 1.2.13 Procedure某些核心函数将C/C+函数指针作为参数，但并不声明这些参数作为指向返回整型值的函数的指针，而是定义了一种特殊的数据类型Procedure。1.2.14 Process Handle进程句柄是惟一一种标识仿真中活动进程的数据结构，由Pro函数集中的核心函数使用。需注意进程句柄是数据结构，而不是整形或指针，因而不能将它们存储在整型或指针变量中。1.2.15 Sar Buffer HandleSar缓冲句柄是惟一一种标识Sar（Segmentation & Reassembly，分段与重组）缓冲区的数据结构。

12、Sar缓冲区缓存包序列，并可对包进行分段和重装。Sar缓冲区由Sar函数集中的核心函数创建，该函数返回访问新缓冲区的Sar缓冲句柄。Sar函数集函数利用Sar缓冲名柄来处理被标识的Sar缓冲区。与其他OPNET数据结构一样，不能将Sar缓冲句柄分配到整型或指针变量中。1.2.16 Vartype除标准的C/C+数据类型和特殊的仿真内核数据类型外，OPNET还提供了另外一种数据类型Vartype。Vartype数据类型可用在变量声明或类型转换语句中，它是OPNET文档中的特殊关键词，表示函数参数可以是多种可能的数据类型之一。类型参数的传递由C描述的调用函数确定，Vartype用于确定哪个函数参数

13、可用来传递多种数据类型。但需要注意的是，Vartype并不像C中的varargs那样可传递多种参数，每个Vartype参数一次只能接受一个传递值。Vartype类型的参数，可接受int、double或指向数据结构的指针。Vartype*是Vartype的一种变体，它可接受指向变量类型的指针。Vartype*类型的参数可接受的值包括：指向整型的指针、指向double的指针、指向数据结构的指针，或参数用于返回filled-in值时指向数据结构指针的指针。每个核心函数中都描述了可被Vartype或Vartype*参数接受的类型值。具有该类型参数的部分核心函数如表1-2所示。表1-2 带Vartype

14、参数的核心函数核心函数变量类型参数op_ima_obj_attr_set()Vartypeop_ima_obj_attr_get()Vartype* (fill-in)op_pk_fd_set()Vartypeop_pk_fd_get()Vartype* (fill-in)op_pk_nfd_set()Vartypeop_pk_nfd_get()Vartype* (fill-in)op_ini_attr_set()Vartypeop_ini_attr_get()Vartype* (fill-in)op_prg_list_insert()Vartype*op_prg_mem_copy()Vart

15、ype*op_prg_mem_free()Vartype*返回变量类型参数的部分核心函数如表1-3所示。表1-3 返回变量类型参数的核心函数核心函数变量类型参数op_prg_list_access()Vartype*op_prg_list_remove()Vartype*op_prg_mem_alloc()Vartype*表1-4 易冲突的函数名accept()index()send()access()kill()signal()audit()link()socket()bind()listen()stat()clear()open()tell()clock()pipe()truncate()

16、close()poll()unlink()connect()read()wait()exit()select()1.3 多线程安全无线模块允许OPNET采用多处理器进行收/发信机管道计算。为确保并行传输的正确性和尽可能快速，五个管道阶段必须采用多线程安全核心函数。核心函数定义了三个多线程安全级别，分别是MT-safe、MT-unsafe和Forced serialization。（1）MT-safe：该类核心函数已手动进行重编码以支持多线程。多个线程可安全地并行执行该类核心函数。（2）MT-unsafe：在该安全级别下，若在核心函数中采用并行处理，将导致性能的下降，达不到预期的结果。使用MT-

17、unsafe核心函数时，应当执行适当的代码序列化（Serialization）。（3）Forced serialization：对于所有已手动重编码以支持多线程的核心函数，仿真内核采用内部互斥来执行严格的序列化。最终每个核心函数将进行手动重编码来支持多线程，它们的状态也将由Forced serialization变为MT-safe。2. 基本核心函数OPNET Modeler10.0提供了21个核心函数集，只有熟悉核心函数才能在建模时方便地进行代码编写。本节按照不同的功能对常用的核心函数作了详细的介绍。2.1 内部模型访问函数集Ima（Internal Model Access，内部模型访问）

18、函数集是一系列提供对仿真实体动态访问的核心函数的集合，其中仿真实体包括仿真属性、对象属性、对象命令（Object Command）和进程状态变量。1. op_ima_obj_attr_get (objid,attr_name,value_ptr)此核心函数的作用是获取给定对象的某属性值，其参数说明如表2-1所示。表2-1 op_ima_obj_attr_get()函数的参数说明参 数类 型描 述objidObjid给定对象的对象IDattr_nameconst char*属性名（必须是给定对象中已定义的，否则将出错）value_ptrVartype*指向存储属性值变量的指针（Vartype*

19、可接受字符串或指向整型 、double以及复合属性对象ID指针。当为字符串时，字符数组必须足够大，以容纳属性值。参数指针类型必须与给定属性的数据类型相匹配，否则将出错。如果属性类型是toggle，返回值即为OPC_BOOLINT_ENABLED或OPC_BOOLINT_DISABLED；如果属性类型是pofile，返回值即为包含访问profile所需的必要信息的pofile specification(PrgT_Profile_Spec) 1）返回值Compcode如果成功获取属性值，即返回OPC_COMPCODE_SUCCESS，否则返回OPC_COMPCODE_FAILURE。如果需要获取

20、给定对象的复合属性值，则若复合属性相等，value_ptr的值即设为复合属性中的一个对象ID，并返回OPC_COMPCODE_SUCCESS；若不相等，则返回OPC_COMPCODE_FAILURE。注意：在复合属性中，所谓的“相等”，是指复合属性中的所有属性都具有相同的名称、类型和值，并且复合属性的所有子对象也相等。2）详解对于网络域对象（子网、节点和链路）、节点域对象（模块）以及预先由网络、节点、进程或链路编辑器定义的复合属性，都可以获取对象属性值。提升的属性值可以从父对象中获取。要引用提升属性，必须为每个中间对象的属性名附加一个点分前缀。例如，若要在节点级获取进程属性，则属性名应在包含该

21、进程的模块名称之前。并不是所有的对象属性都可仿真中调用该函数来获取。比如Simulation/Access字段被标记为N/A的属性就不能通过调用op_ima_obj_attr_get()来获取。此外，该核心函数的命令级别为Forced serialization。3）目的该函数提供了一种在仿真中动态获取对象属性的机制。它可用于处理器或队列确定自身或网络中其它对象的属性值。将该函数与op_ima_obj_attr_set()结合，无需包、ICI或中断递送就可提供远程进程间的通信。4）错误Program Abort：分段错误（由无效值指针、指针所指内存不足或指向无效的attr_name地址所引起）

22、。Recoverable Error：对象无法识别属性名。Recoverable Error：对象ID溢出。Recoverable Error：对象ID指向受限对象（由受护模型中的相关对象引起）。5）相关函数采用op_ima_obj_attr_set()、op_ima_obj_attr_set_db1()、op_ima_obj_attr_set_int32()和op_ima_obj_attr_set_str()设置对象属性值。采用op_ima_sim_attr_get()、op_ima_sim_attr_get_db1()、op_ima_sim_attr_get_int32()和op_ima_

23、sim_attr_get_str()获取仿真属性值。采用op_ima_obj_svar_get()获取进程状态变量值。采用op_ima_obj_command()向对象发出一个命令。采用op_id_self()获取所属处理器或队列的对象ID。采用op_id_from_name()获取对象的对象ID。2. op_ima_obj_attr_set (objid,attr_name,value_ptr)此核心函数的作用是设置给定对象的某属性值，其参数说明如表2-2所示。表2-2 op_ima_obj_attr_set()函数的参数说明参 数类 型描 述objidObjid给定对象的对象IDattr_

24、nameconst char*属性名value_ptrVartype*指定属性需设置的新值1）返回值Compcode如果成功获取属性值，即返回OPC_COMPCODE_SUCCESS，否则返回OPC_COMPCODE_FAILURE。2）详解对于网络域对象（子网、节点和链路）、节点域对象（模块）以及预先由网络、节点、进程或链路编辑器定义的复合属性，都可以设置对象属性值。在对象中可以设置提升对象的值。并不是所有的对象属性都可仿真中调用该函数来设置。比如Simulation/Access字段被标记为N/A的属性就不能通过调用op_ima_obj_attr_set()来设置。此外，该核心函数的命令级

25、别为Forced serialization。3）目的该核心函数提供了一种在仿真过程中动态设置对象属性的机制，可用于处理器或队列控制其他模块。与函数op_ima_obj_attr_get()结合，无需包、ICI或中断递送就可提供远程进程间的通信。不过需要注意的是，远端对象值的改变并不会引起中断，只是当修改后的对象再次调用函数op_ima_obj_attr_get()获取其属性时才会产生影响。4）错误Program Abort：分段错误（由无效值指针、attr_name地址无效或值类型错误所引起）。Recoverable Error：对象无法识别属性名。Recoverable Error：对象I

26、D溢出。Recoverable Error：对象属性为只读。Recoverable Error：属性值无效。Recoverable Error：对象ID指向受限对象。5）相关函数采用op_ima_obj_attr_get()、op_ima_obj_attr_get_db1()、op_ima_obj_attr_get_int32()和op_ima_obj_attr_get_str()设置对象属性值。采用op_ima_sim_attr_get()、op_ima_sim_attr_get_db1()、op_ima_sim_attr_get_int32()和op_ima_sim_attr_get_st

27、r()获取仿真属性值。采用op_ima_obj_svar_get()获取进程状态变量值。采用op_ima_obj_command()向对象发出一个命令。采用op_id_self()获取所属处理器或队列的对象ID。采用op_id_from_name()获取对象的对象ID。3. op_ima_sim_attr_get (attr_type, attr_name, value_ptr)此核心函数的作用是获取仿真属性值，其说明如表2-3所示。表2-3 op_ima_sim_attr_get()函数的参数说明参 数类 型描 述attr_typeint属性类型（可以为OPC_IMA_INTEGER、OPC

28、_IMA_DOUBLE、OPC_IMA_TOGGLE或OPC_IMA_STRING）attr_nameconst char*属性名value_ptrVartype*指定存储属性值变量的指针1）返回值Compcode如果成功获取属性值，即返回OPC_COMPCODE_SUCCESS，否则返回OPC_COMPCODE_FAILURE。2）详解仿真属性与子网发属性、节点属性、模块属性以及进程属性均不同，它不在制定模块规范阶段定义，而在仿真运行期间动态定义。仿真属性是通过一些环境属性机制来进行赋值的，包括仿真命令行、环境数据库（<HOME>/op_admin/env_db<rel&g

29、t;）、shell变量或环境文件。该函数将触发仿真的内部环境数据库扫描可用值，如果无法在现有程序环境中为仿真属性找到一个值，那么它将在标准输出设备上打印一个提示（可用仿真的noprompt环境属性来取消用户提示），请求输入一个值。一旦提示出现，就将打印一个属性的默认值。注意：默认值是调用核心函数时传递给参数的value_ptr值，而不使用进程模型属性列表中的默认初始值。因此在调用该函数时，必须事先定义value_ptr。如果在仿真程序环境中能够找到给定属性，或当提升时值时被显示输入，那么认为函数执行成功并返回值OPC_COMPCODE_SUCCESS。如果内核必须要引用value_ptr的值，

30、则返回OPC_COMPCODE_FAILURE。3）目的该核心函数提供了一种获取在仿真运行期间设置的仿真属性的机制。将该函数与用环境属性来分配仿真属性结合起来，不仅可以获取网络范围内的关键参数，还可获取影响进程逻辑操作的进程级参数。4）错误Program Abort：分段错误（由无效值指针、指针所指内存不足或指向畸形的attr_name参数引起）。Program Abort：内存分配失败。Recoverable Error：属性类型不可识别。5）相关函数采用op_ima_obj_attr_get()、op_ima_obj_attr_get_db1()、op_ima_obj_attr_get_i

31、nt32()和op_ima_obj_attr_get_str()设置对象属性值。采用op_ima_sim_attr_set()、op_ima_sim_attr_set_db1()、op_ima_sim_attr_set_int32()和op_ima_sim_attr_set_str()设置对象属性值。采用op_ima_obj_svar_get()获取进程状态变量值。采用op_ima_obj_command()向对象发出一个命令。2.2 分布函数集Dist（Distribution）函数集是一系列根据特定概率分布产生随机值的核心函数集合。只要具有随机行为的仿真都可以使用这些随机值中的一种或几种，

32、如计算中断的到达时间、产生通信量目的地址或确定节点是否应被去激活等。1. op_dist_load (dist_name, dist_arg0, dist_arg1)此核心函数的作用是加载分布以产生随机值流，其参数说明如表2-4表2-4 op_dist_load()函数的参数说明参 数类 型描 述dist_nameconst char*被加载的分布名称，通常为字符串常量dist_arg0double分布的附加参数#0dist_arg1double分布的附加参数#11）返回值Distribution *指向被加载分布的指针。如果发生可恢复错误，则返回常量OPC_NIL。函数返回值一般存储在Dis

33、tribution *类型的状态变量中，稍后现传递给相关核心函数 op_dist_outcome()。2）详解分布是根据名称来确定的，可以是预定义的分析分布、采用PDF编辑器建立的用户自定义PDF模型或EMA-specified PDF模型。执行预定义的分布可以看作是通过一两个数值参数调用该核心函数的参数化算法。另外两种类型的分布是后缀为“.pd.s”的表格式数据文件，调用该函数时将其加载到内存中。需要注意的是，即使预定义的分布在models/std/base文件夹中有相应的“.pd.s”文件，但这些文件都是零字节的，不包含任何分布信息，只是让分布能够显示在OPNET菜单中。当加载用户自定义的

34、PDF时，将忽略参数dist_arg0和dist_agr1。此外，该核心函数的安全级别为MT-safe。3）目的该核心函数提供作为随机数发生器的概率分布。该函数主要用于加载分布，以在处理器产生的包之间提供随机时间间隔。任何随机分布的仿真参数都可以通过该函数来获取。实际的随机值是通过调用函数op_dist_outcome()来获取的。4）错误Program Abort：分段错误（由无效分布名指针引起）。Program Abort：内存分配失败。Recoverable Error：分布名不可识别。5）相关函数采用op_dist_outcome()或op_dist_outcome_ext()获取已加

35、载分布的随机值。采用op_dist_uniform()获取均匀分布的随机值。采用op_dist_unload()释放分布占用的内存。2. op_dist_outcome (dist_ptr)此核核心函数的作用是为具有特定分布的随机变量产生一个浮点数，其参数说明如表2-5。表2-5 op_dist_outcome()函数的参数说明参 数类 型描 述dist_ptrDistribution*指向被加载分布的指针1）返回值double具有特定分布随机变量的结果。如果发生可恢复错误，则返回常量 OPC_DBL_INVALID。2）详解特定分布可以是预定义的算法分布，也可以是之前通过函数op_dist_

36、load()加载的数字型表格式分布。该核心函数执行表格式分布的列表查询，并对算法分布（如指数分布）进行数字计算。该核心函数使用的随机数流是调用BSD random()过程产生的，所有分布函数集中的函数和发生器模块都可共享此随机数流。随机数流依赖于初始的种子数（seed），如果仿真输入（包括相同的随机seed）相同，则仿真结果可重复。此外，该核心函数的安全级别为MT-safe。3）目的该核心函数提供了一种获取符合某概率分布的随机值的机制。该函数学用于计算处理器产生的包之间的随机时间间隔。任何随机分布的仿真参数都可以通过它来获取。4）错误Program Abort：分段错误（由无效分布指针引起）。

37、Recoverable Error：分布指针为NIL。5）相关函数采用op_dist_load()加载分布。采用op_dist_uniform()获取均匀分布的随机值。采用op_dist_unload()释放分布占用的内存。采用op_dist_outcome_ext()获取用户自定义的随机数发生器产生的随机数。采用op_intrpt_schedule_self()、op_intrpt_schedule_remote()或op_intrpt_schedule_call()分别产生自中断、远程中断和过程中断。3. op_dist_uniform(limit)此核心函数的作用是产生一个均匀分布的随机

38、值，其参数说明如表2-6所示。表2-5 op_dist_uniform()函数的参数说明参 数类 型描 述limitdouble均匀分布的取值范围1）返回值double产生的均匀分布的随机值，范围在0.0，limit 中。2）详解该核心函数使用的随机数流是调用BSD random()过程产生的，所有分布函数集中的函数和发生器模块都可共享此随机数流。随机数流依赖于初始的种子数（seed），如果仿真输入（包括相同的随机seed）相同，则仿真结果可重复。如果参数limit为负数，则返回值将是一个大于limit的均匀分布的负数此外，该核心函数的安全级别为MT-safe。3）目的该核心函数为普通的建模提

39、供了一种获取均匀分布随机数的机制，例如可用于数据链路协议计算随机超进。4）错误无错误捕获5）相关函数采用op_dist_load()加载一个概率分布。采用op_dist_outcome()根据已加载的概率分布，获取一随机值。2.3 进程函数集进程函数集是一系列用于在一个处理器或队列模块中创建和管理多个进程的核心函数的集合。进程是进程模型的一个实例，进程模型是在OPNET的进程编辑器中开发的特定类型进程的行为和功能规范。1. op_pro_create (model_name, ptc_mem_ptr)此核心函数的作用是创建一个新的进程作为特定进程模型的实例，并允许安装parent-to-chi

40、ld共享内存，作为当前进程和创建的子进程间通信机制，其参数说明如表2-7所示。表2-7 op_pro_create()函数的参数说明参 数类 型描 述model_nameconst char*进程模型名称ptc_mem_ptrVartype*当前进程和被创建进程共享的parent-to-child内存块的地址（该内存块格式是用户自定义的。通常若无内存共享，则传递值OPC_NIL）1）返回值Prohandle进一步处理被创建子进程的进程句柄。2）详解仿真内核支持单个队列或处理器模块中任意多个不同类型进程的并存。除了根进程，其他所有进程都通过该核心函数创建。只有当提供的参数process_mode

41、l引用当前仿真中已声明的进程，该核心函数才会执行成功。在为仿真系统的任一处理器或队列模块的进程模型属性赋值，或在通过进程编辑器将进程声明为另一进程的子进程时，均采用进程模型的隐式声明。每个通过该核心函数创建的进程都可以利用共享内存与创建它的进程进行通信。共享内存是用户自定义的内存块，其地址必须作为ptc_mem_ptr参数传递给该函数。此外，该核心函数的安全级别为Forced serialization。3）目的该核心函数提供了一个进程，其可以创建在相同模块中操作的子进程。每个子进程作为一个进程模型实例独立存在，并维持自身的状态。4）错误Program Abort：核心函数需要进程上下文。Pr

42、ogram Abort：无法创建进程。Program Abort：进程的描述符分配失败。Program Abort：初始化进程失败。Recoverable Error：进程模型未被声明。5）相关函数采用op_pro_invoke()调用进程模型。子进程采用op_pro_parmem_access()获取parent_to_child共享内存。采用op_pro_id()确定进程的惟一整数标识符。2. op_pro_destroy_options(pro_handle, options)销毁动态创建的进程和该进程的所有预设事件，其参数说明如表2-8所示。表2-8 op_pro_destroy_op

43、tions ()函数的参数说明参 数类 型描 述pro_handleProhandle被销毁进程的进程句柄optionsint被执行的可选操作1）返回值Compcode表示仿真内核是否成功销毁进程的完成代码，包括OPC_COMPCODE_SUCCESS和OPC_COMPCODE_FAILURE。2）详解该函数允许进程销毁同一模块中的任意其他动态进程，因此根进程是惟一给定模块中不能被销毁的进程。此外，该函数还可移除被销毁进程的所有预设事件。其中，动态进程是通过核心函数op_pro_create()创建的，在仿真中可随时从模型中移除动态进程。适当终止进程可释放分配给进程的动态内存，但这也可能给建模

44、带来一定影响。进程模型在销毁时会有一个特殊的逻辑片断，该片断是进程模型的终止块和销毁进程时仿真内核直接调用的包含其中的代码。代码片断中可能用到状态和临时变量。进程可以销毁自身，这时不返回任何值，除了终止块中的特定操作外，不执行任何操作。注意：内核对释放parent-to-child或参数内存不负任何责任。该核心函数可使用的option有：OPC_PRO_DESTROY_OPT_KEEP_EVENTS核心函数移除被销毁进程的任意预设事件。OPC_PRO_DESTROY_OPT_NONE默认操作。此外，该核心函数的安全级别为Forced serialization。3）目的该核心函数提供了一个进程

45、，其可以创建在相同模块中操作的子进程。每个子进程作为一个进程模型实例独立存在，并维持自身的状态。4）错误Program Abort：核心函数需要进程上下文。Program Abort： 分段错误（由畸形进程句柄导致）。Recoverable Error：进程句柄无效。Recoverable Error：进程句柄指向被销毁进程。Recoverable Error：进程句柄指向远程进程。Recoverable Error：进程句柄指向根进程。Recoverable Error：进程句柄指向活动进程。5）相关函数采用op_pro_create()创建新的进程并获取其句柄。采用op_prg_mem_f

46、ree()释放通过函数op_prg_mem_alloc()分配的内存。采用op_pro_invoke()调用进程模型。采用op_pro_parmem_access()用于子进程获取parent_to_child共享内存。3. op_pro_self()此核心函数的作用是获取当前正在执行的进程的进程句柄。1）返回值Prohandle当前正在执行的进程的进程句柄。在执行与该进程相关的操作时，调用其他核心函数时可使用此句柄。2）详解当前执行的进程通常需要使用其自身的句柄作为进程和中断函数集中其他核心函数的参数。例如，该句柄可作为指针来获取父进程的句柄。其他典型应用包括获取进程的惟一ID，销毁无用的进

47、程本身。此外，该核心函数的安全级别为Forced serialization。3）目的该核心函数为调用该核心函数的进程提供了一个进程句柄，作为进程和中断函数集中其他核心函数的参数。4）错误Program Abort：核心函数需要进程上下文。5）相关函数采用op_pro_id()获取进程的惟一整数ID。采用op_prg_mem_free()销毁进程。采用op_intrpt_port_register ()为特定流或统计中断注册一个进程。采用op_intrpt_type_register()为特定类型中断注册一个进程。4. op_pro_invoke (pro_handle, argmem_ptr

48、)该核心函数的作用是在当前事件和当前模块的上下文中调用进程。被调用进程将被暂停直到函数返回，其参数说明如表2-9所示。表2-9 op_pro_invoke()函数的参数说明参 数类 型描 述pro_handleProhandle被调用进程的进程句柄argmem_ptrVartype*通过函数op_pro_argmem_access()为被调用进程提供的参数内存块的地址1）返回值Compcode表示调用是否成功的完成代码，返回代码包括OPC_COMPCODE_SUCCESS和OPC_COMPCODE_FAILURE。进程句柄过期或调用其他模块的进程都将引起调用失败。2）详解进程可调用同一模块中的

49、其它进程。如果使用其它模块进程的进程句柄来调用该函数将引起可恢复错误。在同一事件中，对函数op_pro_invoke()的调用次数并没有任何限制。换句话说，调用函数op_pro_invoke()所导致中断的进程，可接着利用该函数调用其他进程。这种一连串的进程调用称为当前调用栈，就像C语言中的函数调用栈一样。仿真内核限制进程在当前调用栈中调用其他进程。当进行进程调用时，调用进程可建立一个内存块，供它和被调用进程共享。由于该内存可传递被调用进程的输入和输出参数，因而作为参数内存。若调用进程需要通过函数op_pro_argmem_access()来获取内存块地址，则地址必须作为参数传递给op_pro

50、_invoke()；若无此需要，则应传递常量OPC_NIL。此外，该核心函数的安全级别为Forced serialization。3）目的多个进程可共同处理单一队列或处理器模块上下文中发生的事件。通常对进程进行分层组织，父进程根据不同事件的要求将事件处理任务交给合适的子进程。另外一种进程组织方式就是根据功能行来划分任务，如可根据进程收到的中断类型调用不同的子进程。大多数组织化机制都有一个共通处，即都需要在模块中临时传递对子进程或对等进程的执行控制权。这就需要通过函数op_pro_invoke()来完成，并提供需执行的进程句柄。4）错误Program Abort：核心函数需要进程上下文。Prog

51、ram Abort： 分段错误（由畸形进程句柄导致）。Recoverable Error：进程句柄无效。Recoverable Error：进程句柄指向被销毁进程。Recoverable Error：进程句柄指向远程进程。Recoverable Error：进程句柄指向活动进程。5）相关函数采用op_pro_argmem_access()获取调用参数内存的访问权。采用op_pro_parent()获取父进程的进程句柄。采用op_pro_create()创建新的进程并获取其句柄。5. op_pro_argmem_access ()此函数的作用是获取进程调用所传递的参数内存的地址。1）返回值Var

52、type*调用进程提供的用户自定义内存块的地址。若仿真内核直接调用进程或调用进程不愿传递任何参数内存，则返回符号常量OPC_NIL。2）详解参数内存是一个用户自定义的内存块，其地址由进程调用其他进程时传递。内存的格式和内容都是用户自定义的，只有其地址由仿真内核管理。仿真内核保证只有通过函数传递的内存地址阻塞时，才能被调用进程访问，并将控制权返回给调用进程。地于直接由仿真内核调用的进程，该核心函数将返回一个空地址OPC_NIL。直接由内核调用的进程和通过函数op_pro_invoke()调用的进程应在使用该指针访问参数值之前检查返回的地址是否为OPC_NIL，否则将发生分段错误。调用函数op_p

53、ro_invoke()可使用参数内存机制，这时被调用进程并不需要接收传入的值或向调用进程返回任何数据。在这种情况下，通常在需要参数内存的情况下，调用函数op_pro_invoke()应传递符号常量OPC_NIL。此外，该核心函数的安全级别为Forced serialization。3）目的该核心函数提供了一种在调用进程和被调用进程间共享内存的机制。内存可在调用前建立，以包含输入参数值。被调用进程可以检查检查该参数值，并利用它来处理事件。同样被调用进程可修改内存，以向调用进程返回输出参数，而调用进程可在函数op_pro_invoke()返回之后检查内存的内容。该核心函数提供了一种在调用进程和被调

54、用进程间共享内存的机制。内存可在调用前建立，以包含输入参数值。被调用进程可以检查该参数值，并利用它。4）错误Program Abort：核心函数需要进程上下文。5）相关函数采用op_pro_invoke()调用进程模型。采用op_pro_modmem_access()与同一模块中的其他进程共享信息。采用op_pro_parmem_access()与进程及其父进程共享信息。2.4 事件函数集op_ev_cancel(evhandle)函数的作用是撤销预设的事件，其参数说明如表2-10所示。表2-10 op_ev_cancel()函数的参数说明参 数类 型描 述evhandleEvhandle被取

55、消事件的事件句柄。事件句柄可以通过本函数集中的op_ev_seek_time()、op_ev_next()、op_intrpt_schedule_self()等函数获取1）返回值Compcode表示操作是否成功的完成代码，包括符号常量OPC_COMPCODE_SUCCESS和OPC_COMPCODE_FAILURE。2）详解取消事件就是将其从仿真事件列表中移除，并阻止其向目的模块发送。该函数只能用于取消未决的事件，取消已经发送或正在执行的事件将导致错误发生。因为仿真内核将事件信息缓存到了相应的事件句柄中，这样无需查找就可很快对事件进行定位，所以利用该函数取消事件时不必考虑效率问题。在事件发送之前使用该函数将其取消将比事件发送到目的地后再将其取消更加高效。此外，该核心函数的安全级别为Forced serialization。3）目的该核心函数提供了一种撤销无用事件的机制。该函数常用于取消op_intrpt_schedule_self()函数预设的超时中断事件。如果在超时前收到ack包或有其他中断发生，则该函数将取消超时事件，并重置定时器。4）错误Program Abort： 分段错误（由畸形进程句柄导致）。Recoverable Error：事件句柄指向无效或当前还未预设的事件。Recoverable Error：无法取消当前事件。Re