op_pro_argmem_access()

摘要

获取调用方过程传入的参数内存的地址。

语法

op_pro_argmem_access()
参数 类型 说明
无参数

返回类型

void*

由进程的调用方提供的用户定义内存块的地址。

[当进程由仿真内核直接调用,或调用方过程希望不传入任何参数内存时,该返回值为符号常量 OPC_NIL。]

示例

/* Obtain the address of the argument memory block passed by calling process. */
arg_mem_ptr = op_pro_argmem_access ();

/* If there are arguments present, examine them to 															*/
/* determine the reason for invocation. 															*/
if (arg_mem_ptr != OPC_NIL)
	{
	/* Cast the argument memory into specific data-structure form. */
	pkt_hndlr_ptr = (Pkt_Hndlr_Req_Args*) arg_mem_ptr;

	/* Process the request according to its type. */
	switch (pkt_hndlr_ptr->type)
		{
		case PHR_REQ_INBOUND:
			phr_pkt_inbound (pkt_hndlr_ptr->pkptr, pkt_hndlr_ptr->source);
			break;

		case CHR_REQ_CALL_REMOVE:
			phr_pkt_outbound (pkt_hndlr_ptr->pkptr, pkt_hndlr_ptr->dest);
			break;
		}

详情

参数内存是一个用户定义的内存块,其地址由通过内核过程 op_pro_invoke() 调用另一个进程的进程传入。内存的格式和内容由用户定义,仿真内核只管理其地址。通过 op_pro_invoke() 传入的参数内存地址在被调用进程的整个执行期间均可访问。

对于由仿真内核直接调用的进程(即根进程、接收自中断的进程,或通过 Interrupt 包内核过程注册的进程),op_pro_argmem_access() 返回的值将是空地址的符号常量 OPC_NIL。既可能被内核直接调用、又可能被 op_pro_invoke() 调用的进程,在使用该指针访问参数值之前应当检查返回的地址是否不等于 OPC_NIL,否则可能发生段错误。

调用 op_pro_invoke() 时,参数内存机制的使用是可选的。视应用而定,被调用过程可能不需要传入任何值,也不需要向调用方过程返回任何数据。在这些情况下,约定是在期望参数内存的位置传入符号常量 OPC_NIL。

用途

提供一种在被调用进程与调用方进程之间共享内存的机制。可以在调用之前设置该内存,使其包含“输入参数”值,供被调用进程在事件处理中检查和使用。类似地,被调用进程可以修改该内存以向调用方进程返回“输出参数”,调用方进程可在内核过程 op_pro_invoke() 返回后检查该内存的内容。

错误

  • 程序中止:内核过程要求进程上下文。

参考

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