op_pro_modmem_access()
摘要
获取通过 op_pro_modmem_install() 为拥有当前正在执行进程的队列或处理器模块安装的内存地址。
语法
op_pro_modmem_access ()
| 参数 | 类型 | 说明 |
|---|---|---|
| 无参数 |
返回类型
void*
为队列/处理器模块中所有进程访问而安装的用户自定义内存块的地址。该地址可通过调用内核过程 op_pro_modmem_install() 安装。若该模块中没有任何进程安装过地址,则返回值为符号常量 OPC_NIL。
示例
/* Get the pointer to the module wide variables installed by the root process. */
mod_vars = (X25T_DTE_Mod_Vars *) op_pro_modmem_access ();
/* Get the pointer to the channel block for this channel. */
chan_vars = (X25T_Channel *) op_pro_parmem_access ();
/* Initialize channel state variables. */
chan_vars->number = chan_number;
chan_vars->process = op_pro_self ();
chan_vars->local_addr = local_addr;
chan_vars->remote_addr = remote_addr;
chan_vars->permanent = 0;
chan_vars->data_link = X25C_DTE_DL_OUTSTRM;
chan_vars->application = appl_stream;
详情
该内核过程返回为拥有当前正在执行进程的队列或处理器模块维护的内存地址。每个队列或处理器只维护一个这样的地址变量,仿真内核通过内核过程 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_install() 安装新的模块级共享内存地址
- 使用内核过程 op_pro_parmem_access() 获取与当前进程之父进程共享的内存
- 使用内核过程 op_pro_argmem_access() 获取与当前进程调用者共享的内存