oms_buffer_dequeue()
摘要
移除缓冲区中指定索引处的对象并返回其句柄。
语法
oms_buffer_dequeue (buffer_handle, index, pkt_dequeue_time)
| 参数 | 类型 | 说明 |
|---|---|---|
buffer_handle |
OmsT_Buffer_Handle |
要从中移除元素的缓冲区对象 |
index |
int |
要从缓冲区移除的元素的从 0 开始的索引 |
pkt_dequeue_time |
double |
移除该缓冲区元素时的仿真时间 |
返回类型
void *
位于位置 index 的对象;若 index 不对应任何元素则返回 OPC_NIL。
详细说明
该函数移除存储在缓冲区中位置 index 的元素并返回对应的元素。如果 index 小于 0,或大于或等于缓冲区中的元素数量,则返回 OPC_NIL,且缓冲区内容不受影响。
如果从缓冲区移除了一个元素,缓冲区及其父池的内部大小会相应更新,相关统计量也会随之更新。