op_prg_pmo_alloc()
摘要
分配一个指定类型的池化内存对象。
注意: 该内核过程是一个仅为向后兼容而保留的宏调用。新代码应使用 prg_pmo_alloc()。
语法
op_prg_pmo_alloc (pm_handle)
| 参数 | 类型 | 说明 |
|---|---|---|
pm_handle |
Pmohandle |
池化内存句柄,指定要分配的池化内存对象类型。池化内存句柄可通过内核过程 op_prg_pmo_define() 获得 |
返回类型
void*
指向已分配池化内存对象的指针(最低字节的地址)。如果内存分配失败,返回常量 OPC_NIL。
这种“通用”指针应当被转换为适当的数据类型以便进一步访问。]
示例
节选自:示例模型(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_pmo_alloc() 返回的内存地址可能与该内核过程先前为同一类型池化内存对象返回的地址相同。这是因为通过 op_prg_mem_free() 释放内存块后,又通过 op_prg_pmo_alloc() 再次分配时发生了内存重用。
池化内存通常推荐用于频繁分配和释放相同大小内存块的场合。池化内存分配器可以利用这种分配/释放循环,比 op_prg_mem_alloc() 提供的通用分配器运行得更高效。通常不建议用池化内存获取永不释放的内存(例如在仿真开始时一次性分配的数据结构)。
通过 op_prg_pmo_alloc() 分配的内存可以通过 op_prg_mem_free() 释放,方式与通过 op_prg_mem_alloc() 分配的内存相同。但请注意,用于某一特定类型对象后再释放的内存,只能重新分配给同一类型的对象。
用途
当已知将对相同大小的内存块进行大量分配和释放时,提供一种高效的动态内存分配机制。op_prg_mem_alloc() 提供的通用内存分配器在进行了大量释放操作后,可能在仿真过程中逐渐变慢。op_prg_pmo_alloc() 通过保留一个已释放对象的“池”来避免这一问题,使新的分配能够快速完成。
池化内存的另一个优势是,可以通过仿真调试器 ODB 的 memstats 命令分别跟踪每种类型对象的用量。
错误
- 可恢复错误:Invalid pool memory object handle(通常由于先前 op_prg_pmo_define() 调用失败)
- 可恢复错误:Allocation of object block failed(由于内存资源不足)
参考
- 使用 op_prg_pmo_define() 定义新的池化内存对象类型和/或获取池化内存对象句柄
- 使用 op_prg_pmo_dealloc() 或 op_prg_mem_free() 释放池化内存对象,使其可被重用
- 使用 op_prg_mem_alloc() 分配通用(非池化)内存
- 使用 op_prg_mem_copy() 复制内存块