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>):无法将属性变更请求入队。(由于内存分配失败)

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com