prg_pmo_define_with_props()
摘要
定义一种新的池化内存对象类型,并指定一组期望的属性。
语法
prg_pmo_define_with_props (name, size, increment, properties)
| 参数 | 类型 | 说明 |
|---|---|---|
name |
const char * |
池化内存类别的名称。可以是普通字符串,必要时可包含空格(最长 48 个字符)。该名称用于在内存跟踪报告和跟踪语句中标识池化内存对象类型(例如 ODB 的 memstats 命令或 prg_mem_stats_print() 函数)。 |
size |
size_t |
所定义类别中每个池化内存对象包含的可用存储字节数。 |
increment |
int |
扩展所定义类别的对象池时,作为单个块向操作系统请求的对象数量。 |
properties |
int |
要设置的属性(参见详情)。 |
返回类型
Pmohandle
用于标识新定义内存类别的池化内存对象句柄。在分配单个对象时,该句柄可用于调用 prg_pmo_alloc()。
头文件
prg_mem_funcs.h
示例
static Pmohandle ip_addr_mem_pool;
static int ip_pool_setup = OPC_FALSE;
int *ip_addr_ptr;
if (!ip_pool_setup)
{
/* initialize ip addresses memory pool */
/* No need to pre-clean allocated memory as all ip address fields */
/* are set after allocation */
ip_addr_mem_pool = prg_pmo_define_with_props ("IP Address Storage",
sizeof (int), 256, PRGC_MEM_DONT_CLEAR);
ip_pool_setup = OPC_TRUE;
}
ip_addr_ptr = (int *) prg_pmo_alloc (ip_addr_mem_pool);
*ip_addr_ptr = 0;
详情
该函数的工作方式与 prg_pmo_define() 相同,此外还可以为所定义的池化内存对象类型指定属性。
properties 必须为 0 或下列符号常量之一(也可以是两者的 OR 组合):
PRGC_MEM_DONT_CLEAR——该类型的池化内存对象在分配时不会清零内存PRGC_MEM_POOL_DONT_DEALLOC——当某个内存块中的所有对象都已被释放时,该类型的池化内存对象不会释放该内存块
注意: 在每次分配之前都尝试创建池化内存类别是可行的,但并不可取,因为 prg_pmo_define_with_props() 相对于 prg_pmo_alloc() 计算开销较大,而每次分配只需后者即可。
用途
允许创建新的池化内存对象类型,从而可以通过 prg_pmo_alloc() 函数执行分配。池化内存对象类型可以具有一组自定义属性。
错误
- 可恢复错误:Initial allocation of object block failed(由于内存资源不足)
参考
- 使用
prg_pmo_define()定义新的池化内存对象类型或获取池化内存对象句柄 - 使用
prg_pmo_alloc()使用池化内存对象句柄分配对象 - 使用
prg_mem_free()释放池化内存对象,使其可被重用 - 使用
prg_mem_alloc()分配通用(非池化)内存 - 使用
prg_mem_copy()复制内存块