op_pro_modmem_install()
摘要
安装一个与当前模块关联的内存地址,其他进程可通过内核过程 op_pro_modmem_access() 访问它。
语法
op_pro_modmem_install (mem_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
mem_ptr |
void* |
要安装为模块级共享内存的内存块的地址 [该内存块只能由用户定义的进程分配和初始化。仿真内核只维护所提供的地址并将其与当前模块关联。内核不了解该内存块的大小。] |
返回类型
void
无返回值。
示例
/* Allocate module-wide variable block. */
tp_mv_ptr = (Tp_Proc_Var*) op_prg_mem_alloc (sizeof (Tp_Proc_Var));
/* If the allocation was successful, initialize the variable block. */
if (tp_mv_ptr != OPC_NIL)
{
/* Clear out counters and statistics. */
tp_mv_ptr->num_sess_active = 0;
tp_mv_ptr->total_pkts = 0;
tp_mv_ptr->total_bytes = 0;
tp_mv_ptr->accum_pk_delay = 0.0;
tp_mv_ptr->num_discards = 0;
/* Set module-wide timers. */
tp_global_timers_init (tp_mv_ptr);
/* Install the module-wide variable block for all dynamic process to access. */
op_pro_modmem_install (tp_mv_ptr);
}
详情
该内核过程为拥有当前正在执行进程的队列或进程模块安装并维护一个内存地址。每个队列或处理器只维护一个这样的地址变量,仿真内核通过内核过程 op_pro_modmem_access() 和 op_pro_modmem_install() 允许进程访问它。最初该内存地址被设置为符号常量 OPC_NIL 的值。该值将持续有效,直到某次对 op_pro_modmem_install() 的调用将其替换为其他值。
这一对内核过程的设计用途是让进程建立一块公共存储区域,用于存放必须在单个模块的多个进程之间共享的信息。通常由某个进程负责分配(例如通过 op_prg_mem_alloc())一块足够大、可容纳应用专用数据结构的内存块;该进程随后初始化这个数据结构,并安装该内存块的地址供其他进程访问。进程可以根据需要更新和/或检查该数据结构的内容,以实现自身功能并与其他进程协调活动。
模块中的任何进程都可以通过再次调用 op_pro_modmem_install() 来替换已安装的内存地址。如果被替换的地址属于动态分配的内存,则必要时由进程负责释放它以节省内存;通过 op_pro_modmem_access() 不再能够访问旧值。可以安装常量 OPC_NIL,以表示该模块的进程没有任何共享内存。
用途
提供一种在给定模块的所有进程之间共享内存的机制。任何进程都可以调用内核过程 op_pro_modmem_install() 注册一个供模块所有进程访问的内存地址。仿真内核在该模块中存储这一地址,并允许通过调用 op_pro_modmem_access() 取回它。所引用内存块的结构及其内容的解释均由用户定义。
该机制旨在支持这样的设计:同一模块中的多个进程通过修改和检查公共存储区域中的变量来协调各自的活动。
错误
- 程序中止:内核过程需要进程上下文。
参考
- 使用内核过程 op_pro_modmem_access() 获取新的模块级共享内存地址
- 使用内核过程 op_pro_parmem_access() 获取与当前进程之父进程共享的内存
- 使用内核过程 op_pro_argmem_access() 获取与当前进程调用者共享的内存