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(由于内存资源不足)

参考

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