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>)的传出更新请求入队。(由于内存分配失败)
参考
- 使用 op_ima_obj_attr_set() 之类的内核过程设置对象的属性而不将变更通知 HLA-PM
- 使用内核过程 op_hla_attr_change_notify() 让 HLA-PM 检查对象的所有已发布属性是否可能发生变更