op_hla_obj_attr_enqueue()
注意: 需要 High-Level Architecture 功能
摘要
将指定对象中某个属性的变更通知 HLA-PM。
语法
op_hla_obj_attr_enqueue (objid, attr_name)
| 参数 | 类型 | 说明 |
|---|---|---|
objid |
Objid |
目标对象的对象 ID |
attr_name |
const char * |
目标属性的名称 |
返回类型
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;
. . .
op_ima_obj_attr_get (row_id, "Number Units", &num_units);
op_ima_obj_attr_set (row_id, "Number Units", ++num_units);
op_hla_obj_attr_enqueue (node_id, "Number Units");
详情
该内核过程将 attr_name 的变更通知 HLA-PM,这样,如果该属性映射到一个已发布的 HLA 属性,则在当前仿真时间的所有事件处理完毕后,会生成一个合适的 RTI 属性更新事件。给定对象的所有变更都通过单次 RTI 属性更新发送。
用途
提供了一种机制,让 HLA-PM 立即登记一次属性变更,以便最终生成合适的 RTI 属性更新。
错误
- 可恢复错误:Objid(
<objid>):无法将属性(<attr_name>)的传出更新请求入队。(由于内存分配失败)
参考
- 使用 op_ima_obj_attr_set() 之类的内核过程设置对象的属性而不将变更通知 HLA-PM
- 使用内核过程 op_hla_obj_attr_set() 让 HLA-PM 自动考虑属性变更
- 使用内核过程 op_hla_attr_change_notify() 让 HLA-PM 检查对象的所有已发布属性是否可能发生变更