oms_buffer_pk_pool_create()
摘要
创建一个新的内存池,用于管理以字节计的数据包。
语法
oms_buffer_pk_pool_create (max_bytes, max_packets, insert_proc, pool_stats, pool_name, user_data_ptr, status_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
max_bytes |
double |
该池可容纳的最大字节数 |
max_packets |
double |
该池可容纳的最大数据包数 |
insert_proc |
OmsT_Buffer_Insertion_Criteria_Proc |
每当有新数据包加入该池的某个缓冲区时调用的函数 |
pool_stats |
OmsT_Buffer_Stats * |
统计量句柄数组 |
pool_name |
const char * |
为该池关联的名称,用于 ODB 跟踪 |
user_data_ptr |
void * |
与该池关联的任意用户数据 |
status_ptr |
OmsT_Buffer_Create * |
指示该新池创建成功或失败(及原因)的标志 |
返回类型
OmsT_Buffer_Pool_Handle
创建的池对象;若操作失败则为 OPC_NIL。
详细说明
该函数是 oms_buffer_pool_create() 的专用版本,其中元素为数据包,单元为字节。oms_buffer_pk_pool_create() 自动指定的参数为
- size_proc:设置为使用 op_pk_total_size_get() 的函数
- destroy_proc:设置为使用 op_pk_destroy() 的函数
- trace_proc:设置为返回包含数据包 ID 的字符串的函数
- ODB 跟踪字符串设置为 “packet”、“packets”、“byte” 和 “bytes”
更多背景信息,请参见缓冲区与池的创建以及 oms_buffer_pool_create()的详细说明部分。