op_hla_obj_attr_set()

注意: 需要 High-Level Architecture 功能

摘要

为指定对象中的某个属性赋值,并将该变更通知 HLA-PM。

语法

op_hla_obj_attr_set (objid, attr_name, value)
参数 类型 说明
objid Objid 目标对象的对象 ID
attr_name const char * 目标属性的名称
value void* 指定属性的新值
[该参数可以接受整型、双精度或字符串值。]

返回类型

Compcode

完成代码,指示属性赋值或请求入队的成功或失败。如果属性已更新且请求已排队以供 HLA-PM 后续处理,该内核过程返回 OPC_COMPCODE_SUCCESS,否则返回 OPC_COMPCODE_FAILURE。

示例

op_ima_obj_attr_get (my_id, "Update Request", &value);
if (value != request_value)
	{
	op_hla_obj_attr_set (node_id, "Update Time", op_sim_time ());

详情

该内核过程首先调用 op_ima_obj_attr_set() 执行赋值(详见该内核过程)。如果赋值成功,则将变更通知 HLA-PM,这样,如果该属性映射到一个已发布的 HLA 属性,则在当前仿真时间的所有事件处理完毕后,会生成一个合适的 RTI 属性更新事件。给定对象的所有变更都通过单次 RTI 属性更新发送。

使用此内核过程比先使用 op_ima_obj_attr_set()、再使用 op_hla_attr_change_notify() 让 HLA-PM 判断哪些属性已被修改更为高效。

用途

提供了一种机制,可在仿真运行过程中动态分配对象属性,并让 HLA-PM 立即登记该变更,以便最终生成合适的 RTI 属性更新。

错误

  • 可恢复错误:Objid(<objid>):无法将属性(<attr_name>)的传出更新请求入队。(由于内存分配失败)

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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