op_hla_obj_notification_disable()
注意: 需要 High-Level Architecture 功能
摘要
向 HLA-PM 表明:对于指定对象,RTI 对象映射、属性更新或对象解除映射不再为调用者产生远程中断。
语法
op_hla_obj_notification_disable (objid)
| 参数 | 类型 | 说明 |
|---|---|---|
objid |
Objid |
此前在 op_hla_obj_notification_enable() 调用中使用过的对象的对象 ID |
返回类型
Compcode
完成代码,指示请求入队的成功或失败。如果请求已成功入队、留待 HLA-PM 后续处理,该内核过程返回 OPC_COMPCODE_SUCCESS,否则返回 OPC_COMPCODE_FAILURE。
示例
Using an interaction to disable notification
Packet * pk_ptr;
unsigned long hla_id;
Objid opnet_id;
/* Extract the HLA ID from an incoming interaction */
pk_ptr = op_pk_get (op_intrpt_strm());
op_pk_nfd_get(pk_ptr, “HLA ID”, &hla_id);
op_pk_destroy(pk_ptr);
if (op_hla_id_hla_to_opnet_map(hla_id, &opnet_id) == OPC_COMPCODE_SUCCESS)
{
op_hla_obj_notification_disable(opnet_id);
}
详情
停止接收某个对象映射变化通知的请求,只有在同一仿真时刻稍后 HLA-PM 执行时才会被处理。如果存在与该内核过程所用对象 ID 相关的待处理远程中断,它们会在 HLA-PM 处理该禁用通知请求之前先送达该内核过程的调用者。
用途
提供了一种在收到某对象的 RTI 属性更新时停止获知通知的机制。
错误
- 可恢复错误:Objid(
<objid>):无法为 objid(<objid>)入队属性更新通知的取消请求。(由于内存分配失败)
参考
- 使用内核过程 op_hla_obj_notification_enable() 请求在对象与 RTI 对象映射/解除映射时、或对象的属性被外部仿真修改时获得通知
- 使用内核过程 op_hla_attr_update_list_get() 获取最近一次更新中被修改的属性名称列表