op_ev_state_install()

摘要

安装一个事件状态,使其与同一线程中创建的所有事件关联。

语法

op_ev_state_install (client_state_ptr, state_print_proc)
参数 类型 说明
client_state_ptr void* 要安装的事件状态数据结构。使用 OPC_NIL 可移除先前已安装的事件状态。
state_print_proc SimT_Ev_State_Print_Meth 用于打印事件状态的回调,若没有则为 OPC_NIL。(仅在启用 ODB 时使用。)

返回类型

void *

先前安装的状态,若没有则为 OPC_NIL。

示例

void
my_data_print (const void * ev_state_ptr, PrgT_List * dest_lptr)
	{
	const My_Model_Data * data_ptr = (const My_Model_Data *)ev_state_ptr;

	/* Generate text strings based on value of state pointer */
	/* and append to 'dest_lptr'                             */

	}

. . .

My_Model_Data * data_ptr;
data_ptr = allocate_and_set_model_data ();

/* Associate model data with the packet arrival interrupt */
op_ev_state_install (data_ptr, my_data_print);
op_pk_send (pk_ptr, 0);
op_ev_state_install (OPC_NIL, OPC_NIL);

详情

事件状态安装后,将与此后创建的所有事件关联。要停止将事件状态与事件关联,请使用空指针再次调用该函数。

由于仿真内核不了解事件状态的内容,你必须确保 client_state_ptr 具有合适的数据类型。

当使用 ODB 中的 evprint 打印事件状态时,将调用 state_print_proc。该回调必须具有以下原型:

typedef void
(*SimT_Ev_State_Print_Meth) (void *state_ptr, PrgT_List *dump_lptr);

state_print_proc 必须向 *dump_lptr 添加新条目。状态信息通过 *state_ptr 传入。使用 prg_mem_alloc() 为添加到列表的字符串分配内存。仿真内核会自动释放所有内存。

用途

该函数安装要与事件关联的事件状态信息。事件状态信息提供了一种比 ICI 更快的随事件传递自定义信息的方式。有关详情,参见 Modeling Concepts 手册“使用事件状态通信“ 第 355 页。

错误

  • 无。

参考

  • 使用内核过程 op_ev_state() 获取与事件关联的事件状态

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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