oms_buffer_pool_flush()
摘要
遍历池的缓冲区中的元素,并移除 flush 过程返回 true 的每一个元素。
语法
oms_buffer_pool_flush (buffer_pool_handle, flush_proc, user_data_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
buffer_pool_handle |
OmsT_Buffer_Pool_Handle |
要清空(flush)的缓冲区池对象 |
flush_proc |
OmsT_Buffer_Element_Flush_Proc |
用于确定要从池中清空哪些元素的函数 |
user_data_ptr |
void * |
传递给 flush_proc 的用户数据 |
返回类型
无。
详细说明
该函数遍历池中每个缓冲区(及其子池)里的元素。对每个元素,都会以该元素、该元素在缓冲区中的插入时间以及 user_data_ptr 为参数调用指定的 flush_proc。如果 flush_proc 返回 OPC_TRUE,该元素将从缓冲区中被移除,并使用在根池创建时指定的过程将其销毁。详细信息请参见 oms_buffer_pool_create()。
该清空(flush)过程的原型如下:
Boolean OmsT_Buffer_Element_Flush_Proc
void *element,
double insertion_time,
void *user_data_ptr);