op_hla_obj_info_get()
注意: 需要 High-Level Architecture 功能
摘要
获取与某个 Riverbed Modeler 对象关联的 HLA 信息。
语法
op_hla_obj_info_get (objid, obj_info_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
objid |
Objid |
目标 Riverbed Modeler 对象的对象 ID |
obj_info_ptr |
Hla_Obj_Info * |
指向某个变量的指针,该变量将被填入相应的 RTI 信息 |
返回类型
Compcode
完成代码,指示获取 HLA 信息的成功或失败。如果信息已成功获取,该内核过程返回 OPC_COMPCODE_SUCCESS,否则返回 OPC_COMPCODE_FAILURE。
示例
Hla_Obj_Info obj_info;
result = op_hla_obj_info_get (node_id, &obj_info);
if (result == OPC_COMPCODE_SUCCESS)
{
printf (" Node ID %d has just been mapped to HLA object %d\n",
node_id, obj_info.rti_id);
详情
该内核过程根据对象能否映射到 HLA 对象以及是否实际已映射,填充 obj_info_ptr 的各个字段。
Hla_Obj_Info 是由三个字段组成的结构:
- can_be_mapped——如果根据提供给 HLA-PM 的映射文件,该 Riverbed Modeler 对象可以映射到 RTI 对象,则设置为 OPC_TRUE,否则为 OPC_FALSE。
- is_mapped——如果该 Riverbed Modeler 对象当前已映射到某个 RTI 对象,则设置为 OPC_TRUE,否则为 OPC_FALSE。若为 OPC_TRUE,则字段 rti_id 具有有效值。
- rti_id——如果 is_mapped 为 OPC_TRUE,该字段包含 RTI 用于标识与 Riverbed Modeler 对象映射的 RTI 对象的 ID。
用途
提供了一种获取 Riverbed Modeler 对象 HLA 信息的机制。
错误
- 可恢复错误:没有 HLA ID 与 OPNET ID(
<objid>)映射。
参考
- 使用内核过程 op_hla_id_hla_to_opnet_map() 获取某个 HLA 对象的 Riverbed Modeler ID