op_hla_attr_update_list_get()
注意: 需要 High-Level Architecture 功能
摘要
提供一个列表,列出最近被外部仿真修改的属性。
语法
op_hla_attr_update_list_get (objid)
| 参数 | 类型 | 说明 |
|---|---|---|
objid |
Objid |
其 RTI 属性更新已通知到进程模型的对象 ID |
返回类型
List*
被更新属性的名称列表。
示例
List * attr_list;
int i;
/* Obtain list of attributes names from HLA-PM */
attr_list = op_hla_attr_update_list_get (node_id);
printf (" Node ID %d : list of updated attributes\n", node_id);
for (i = 0; i < op_prg_list_size (attr_list); i++)
{
const char * name =
(const char *)op_prg_list_access (attr_list, i);
printf (" [%d] \"%s\"\n", i, name);
}
详情
当 HLA-PM 收到 RTI 属性更新时,会向每个使用 op_hla_obj_notification_enable() 注册过的进程模型投递一个远程中断。处理该远程中断时,使用 op_hla_attr_update_list_get() 查明因这次 RTI 更新而被修改了哪些属性。
注意: 返回的列表归 HLA-PM 所有,op_hla_attr_update_list_get() 的调用者不应删除该列表或其元素。此外,该函数只应在处理由属性更新触发的远程中断期间调用。该中断处理完毕后,列表可能不再有效。在其他情况下调用它的结果是不确定的。
用途
提供了一种机制,用于发现最近一次更新中哪些属性被修改。
错误
- 可恢复错误:Objid(
<objid>):未找到 HLA 映射。
参考
- 使用内核过程 op_hla_obj_notification_enable() 请求在对象的属性被其他联邦成员修改时获得通知
- 使用内核过程 op_hla_obj_notification_disable() 停止通知