prg_pmo_define()
摘要
定义一种新的池化内存对象类型,并返回一个句柄,供执行此类对象的分配时使用。
语法
prg_pmo_define (name, size, increment)
| 参数 | 类型 | 说明 |
|---|---|---|
name |
char * |
池化内存类别的名称。可以是普通字符串,必要时可包含空格(最长 48 个字符)。该名称用于在内存跟踪报告和跟踪语句中标识池化内存对象类型(例如 ODB 的 memstats 命令或 prg_mem_stats_print() 函数)。 |
size |
size_t |
所定义类别中每个池化内存对象包含的可用存储字节数。 |
increment |
int |
扩展所定义类别的对象池时,作为单个块向操作系统请求的对象数量。 |
返回类型
Pmohandle
用于标识新定义内存类别的池化内存对象句柄。在分配单个对象时,该句柄可用于调用 prg_pmo_alloc()。
头文件
prg_mem_funcs.h
示例
/* 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 = 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*) prg_pmo_alloc (dp_pmh);
/* Initialize the data structure */
dp_ptr->packet = pkptr;
dp_ptr->frag_size = log_size;
dp_ptr->format = format;
详情
池化内存通常推荐用于频繁分配和释放相同大小内存块的场合。池化内存分配器可以利用这种分配/释放循环,比 prg_mem_alloc() 提供的通用分配器运行得更高效。通常不建议用池化内存获取永不释放的内存(例如在仿真开始时一次性分配的数据结构)。
此函数返回的池化内存句柄通常保存在进程的状态变量中,以便此后随时用于分配。多个进程或用户代码的不同部分可以分别使用相同的 name 参数调用 prg_pmo_define() 来创建池化内存类别。但冗余调用会被检测出来且不产生效果。在这种情况下,每次调用都会返回等效的句柄,该函数起到一种会合(rendezvous)机制的作用,使模型的多个组件无需全局变量即可共享一个池化内存类别。
注意: 在每次分配之前都尝试创建池化内存类别是可行的,但并不可取,因为 prg_pmo_define() 相对于 prg_pmo_alloc() 计算开销较大,而每次分配只需后者即可。
用途
允许创建新的池化内存对象类型,从而可以通过 prg_pmo_alloc() 函数执行分配。当已知将对相同大小的内存块进行大量分配和释放时,池化内存提供一种高效的动态内存分配机制。prg_mem_alloc() 提供的通用内存分配器在进行了大量释放操作后,可能在仿真过程中逐渐变慢。prg_pmo_alloc() 通过保留一个已释放对象的“池”来避免这一问题,使新的分配能够快速完成。池化内存还有一个额外的好处:可以通过仿真调试器 ODB 的 memstats 命令或 prg_mem_stats_print() 函数单独跟踪每种对象类型的用量。
错误
- 可恢复错误:Initial allocation of object block failed(由于内存资源不足)
参考
- 使用
prg_pmo_define_with_props()定义具有自定义属性的池化内存对象类型 - 使用
prg_pmo_alloc()使用池化内存对象句柄分配对象 - 使用
prg_mem_free()释放池化内存对象,使其可被重用 - 使用
prg_mem_alloc()分配通用(非池化)内存 - 使用
prg_mem_copy()复制内存块