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() 获取与事件关联的事件状态