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>)。(由于内存分配失败)

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com