op_hla_obj_notification_enable()
注意: 需要 High-Level Architecture 功能
摘要
请求在收到指定对象的 RTI 属性更新时获得通知。
语法
op_hla_obj_notification_enable (objid, map_ec, attr_updt_ec, unmap_ec)
| 参数 | 类型 | 说明 |
|---|---|---|
objid |
Objid |
对象的对象 ID;每当收到该对象的 RTI 属性更新时,将为调用者产生中断 |
map_ec |
int |
当 Riverbed Modeler 对象映射到 RTI 对象时,所产生的中断中使用的事件代码 |
attr_updt_ec |
int |
当 Riverbed Modeler 对象的属性因 RTI 更新而被修改时,所产生的中断中使用的事件代码 |
unmap_ec |
int |
当 Riverbed Modeler 对象不再与 RTI 对象映射时,所产生的中断中使用的事件代码 |
返回类型
Compcode
完成代码,指示请求入队的成功或失败。如果请求已成功入队、留待 HLA-PM 后续处理,该内核过程返回 OPC_COMPCODE_SUCCESS,否则返回 OPC_COMPCODE_FAILURE。
示例
static void traverse_topo (Objid subnet_id)
{
int i, child_count, child_id;
char model [200];
. . .
/* Fixed nodes */
child_count = op_topo_child_count (subnet_id, OPC_OBJTYPE_NODE_FIX);
for (i = 0; i < child_count; i++)
{
child_id = op_topo_child (subnet_id, OPC_OBJTYPE_NODE_FIX, i);
if (op_ima_obj_attr_get (child_id, "model", model) == OPC_COMPCODE_SUCCESS)
{
if (!strcmp (model, "HLA_Object"))
{
/* Found one, request notification of HLA mapping, */
/* attribute updates, and unmp using event codes */
/* set to 3 * object id + (0, 1, 2) respectively */
/* to be able to distinguish the events. */
op_hla_obj_notification_enable (child_id,
child_id * 3 + MAP_CODE_MOD,
child_id * 3 + UPDATE_CODE_MOD,
child_id * 3 + UNMAP_CODE_MOD);
详情
多种来自 RTI 的事件都可能为希望获知这些事件的进程模型安排远程中断。这些事件是:
- Riverbed Modeler 对象与新发现的 RTI 对象建立映射
- 基于收到的 RTI 属性更新,Riverbed Modeler 对象的某些属性被修改
- RTI 对象被销毁后映射随之终止
进程模型可以请求在指定对象上发生上述三种事件中任意一种时获得通知。当该事件发生在指定对象上时,会为该内核过程的调用者安排一个远程中断。与该远程中断关联的事件代码,是针对该触发对象最后一次调用 op_hla_obj_notification_enable() 时所提供的值。远程中断在与该事件对应的 HLA 时刻送达。
常量 OPC_HLA_OBJ_IGNORE 应用作事件代码,表示相应事件不应触发远程中断。
如果进程模型对先前已使用过的对象 ID 再次调用 op_hla_obj_notification_enable(),则新的一组事件代码会覆盖先前定义的一组。
用途
提供了一种在收到指定对象的 RTI 属性更新、或该对象被映射或解除映射时获得通知的机制。
错误
- 可恢复错误:Objid(
<id>):无法为<objid <id>;入队对象通知请求,事件代码<map_ec>、<attr_updt_ec>、<unmap_ec>)。(由于内存分配失败)
参考
- 使用内核过程 op_hla_attr_update_list_get() 获取最近一次更新中被修改的属性名称列表
- 使用内核过程 op_hla_obj_notification_disable() 停止在对象的属性被外部仿真修改、或对象被映射或解除映射时获得通知