op_prg_pmo_define()

摘要

定义一种新的池化内存对象类型,并返回在对此类对象执行分配时使用的句柄。

注意: 该内核过程是一个仅为向后兼容而保留的宏调用。新代码应使用 prg_pmo_define()。

语法

op_prg_pmo_define (name, size, increment)
参数 类型 说明
name const char* 池化内存类别的名称。可以是普通字符串,必要时可包含空格(最大长度 48 个字符)。该名称用于在内存跟踪报告和跟踪语句中标识池化内存对象类型(例如 ODB 的 memstats 命令)。
size size_t 所定义类别中每个池化内存对象包含的可用存储字节数。
increment int 扩展所定义类别的对象池时,作为单个块向操作系统请求的对象数量。

返回类型

Pmohandle

用于标识新定义内存类别的池化内存对象句柄。在实际分配单个对象时,该句柄可用于调用 op_prg_pmo_alloc()。如果尝试定义过程中发生错误,该函数返回符号常量 OPC_PMO_INVALID。

示例

节选自:示例模型(std/x25);外部文件 x25_funcs.ex.c;函数 x25_dp_create()

/* Pooled memory is used to allocate data packets since they are frequently created */
/* and destroyed. If the pooled memory object had not yet been defined, do so now, */
/* prior to allocation. */
if (dp_defined == OPC_FALSE)
	{
	dp_pmh = op_prg_pmo_define ("X25 buffer data packet",
		sizeof (X25T_Data_Packet), 32);

	/* Prevent redundant definition. */
	dp_defined = OPC_TRUE;
	}

/* Allocate a new structure to buffer a data packet. */
dp_ptr = (X25T_Data_Packet*) op_prg_pmo_alloc (dp_pmh);

/* Initialize the data structure */
dp_ptr->packet = pkptr;
dp_ptr->frag_size = log_size;
dp_ptr->format = format;

详情

池化内存通常推荐用于频繁分配和释放相同大小内存块的场合。池化内存分配器可以利用这种分配/释放循环,比 op_prg_mem_alloc() 提供的通用分配器运行得更高效。通常不建议用池化内存获取永不释放的内存(例如在仿真开始时一次性分配的数据结构)。

该内核过程返回的池化内存句柄通常存储在进程的状态变量中,以便此后随时用于执行分配。多个进程或用户代码段可以分别使用相同的 name 参数调用 op_prg_pmo_define() 来创建池化内存类别。但冗余调用会被检测到且不产生作用。在这种情况下,每次调用都会返回等效的句柄,该内核过程充当一种会合机制,使模型的多个组件无需全局变量即可共享一个池化内存类别。注意,虽然可以在每次分配之前都尝试创建池化内存类别,但这并不可取,因为内核过程 op_prg_pmo_define() 相比内核过程 op_prg_pmo_alloc() 计算开销更大,而每次分配只需后者即可。

用途

允许创建新的池化内存对象类型,以便通过内核过程 op_prg_pmo_alloc() 执行分配。当已知将对相同大小的内存块进行大量分配和释放时,池化内存提供一种高效的动态内存分配机制。op_prg_mem_alloc() 提供的通用内存分配器在进行了大量释放操作后,可能在仿真过程中逐渐变慢。op_prg_pmo_alloc() 通过保留一个已释放对象的“池”来避免这一问题,使新的分配能够快速完成。池化内存的另一个优势是,可以通过仿真调试器 ODB 的 memstats 命令分别跟踪每种类型对象的用量。

错误

  • 可恢复错误:Initial allocation of object block failed(由于内存资源不足)

参考

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