op_hla_attr_change_notify()
注意: 需要 High-Level Architecture 功能
摘要
向 HLA-PM 表明应检查指定对象的所有已发布属性是否可能发生值变化,并在必要时生成相应的 RTI 属性更新。
语法
op_hla_attr_change_notify (objid)
| 参数 | 类型 | 说明 |
|---|---|---|
objid |
Objid |
需要检查属性更新的对象 ID |
返回类型
Compcode
完成代码,指示请求入队的成功或失败。如果请求已成功排队以供 HLA-PM 后续处理,该过程返回 OPC_COMPCODE_SUCCESS。如果请求无法入队,则返回 OPC_COMPCODE_FAILURE。
示例
op_ima_obj_attr_get (my_id, "Update Request", &value);
if (value != request_value)
{
int num_units;
double cost;
. . .
op_ima_obj_attr_get (row_id, "Number Units", &num_units);
op_ima_obj_attr_set (row_id, "Number Units", ++num_units);
op_ima_obj_attr_get (row_id, "Cost", &cost);
op_ima_obj_attr_set (row_id, "Cost", (cost * 0.5));
}
op_hla_attr_change_notify (node_id);
详情
当映射到 High-Level Architecture 实例的对象的属性正在被修改时,需要通知 HLA-PM。一种方法是使用 op_ima_obj_attr_set() 之类的内核过程来更新各种属性。完整的属性变更集应用完毕后,调用 op_hla_attr_change_notify() 将标记该对象,使 HLA-PM 能够检查已发布属性的任何值变化。
HLA-PM 的检查仅在 HLA-PM 执行时发生。如果在当前仿真时间内应用了更多变更,HLA-PM 只能看到最后的变更。当某个属性的值被传递给 RTI 进行更新时,HLA-PM 会记录该值。由 op_hla_attr_change_notify() 触发的后续检查只会对已变化的属性值产生 RTI 更新。
如果你希望检查属性的每一次变更,即使该变更只是重新赋回先前的值,请使用 op_hla_obj_attr_set()。如果你使用 op_hla_obj_attr_set(),就不要使用 op_hla_attr_change_notify()。
用途
提供了一种机制,使 HLA-PM 能够在属性未通过 op_hla_obj_attr_set() 修改之后生成适当的属性更新。更新将通过 op_ima_obj_attr_set() 或由仿真内核直接进行。
错误
- 可恢复错误:Objid(
<objid>):无法将属性变更请求入队。(由于内存分配失败)
参考
- 使用内核过程 op_hla_obj_attr_set() 让 HLA-PM 自动考虑属性变更
- 使用内核过程 op_hla_obj_attr_enqueue() 让 HLA-PM 生成相应的 RTI 属性更新。