op_hla_attr_info_get()
注意: 需要 High-Level Architecture 功能
摘要
获取与某个对象的属性相关的 RTI 信息。
语法
op_hla_attr_info_get (objid, attr_name, attr_info_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
objid |
Objid |
目标对象的对象 ID |
attr_name |
const char * |
目标对象的属性名称 |
attr_info_ptr |
Hla_Attr_Info * |
指向一个结构的指针,如果执行成功,该结构将被填充 |
返回类型
Compcode
完成代码,指示数据获取的成功或失败。如果能够收集到属性信息,该内核过程返回 OPC_COMPCODE_SUCCESS,否则返回 OPC_COMPCODE_FAILURE。
示例
static void check_attr_info (Objid obj_id, const char * attr_name)
{
Hla_Attr_Info attr_info;
Compcode result;
result = op_hla_attr_info_get (obj_id, attr_name, &attr_info)
}
详情
当 Riverbed Modeler 对象被映射到一个已发现的 RTI 对象时,基于提供给 HLA-PM 的映射文件,Riverbed Modeler 属性中的一个子集会被映射到相应的 RTI 属性。每个属性可以是已发布的(此时 Riverbed Modeler 联邦成员中的变更将被发送给其他联邦成员),也可以是被订阅的(此时其他联邦成员所做的变更将被 HLA-PM 接收并应用到 Riverbed Modeler 属性上)。
使用该内核过程可以确定 Riverbed Modeler 对象的某个属性当前是否映射到某个 RTI 属性。
Hla_Attr_Info 是一个由三个字段组成的结构:
is_published——如果属性已发布则设为OPC_TRUE,否则为OPC_FALSE。is_subscribed——如果属性被订阅则设为OPC_TRUE,否则为OPC_FALSErti_id——如果属性已发布或被订阅,该字段包含 RTI 用于标识目标属性的 ID。如果属性既未发布也未订阅,该字段保持未定义。
用途
提供了一种获取与对象属性相关的 RTI 信息的方式。
错误
- 可恢复错误:Objid(
<objid>):无法获取属性(“<attr_name>”)的信息。 - 可恢复错误:Objid(
<objid>):解析属性名称(“<attr_name>”)时出错。
参考
- 使用内核过程 op_hla_obj_info_get() 获取 Riverbed Modeler 对象的 RTI 信息