oms_buffer_access()
摘要
返回指定缓冲区中位于位置 index 的对象(如果该元素存在)。在这种情况下,元素插入的时间也会一并返回给调用者。
语法
oms_buffer_access (buffer_handle, index, insertion_time_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
buffer_handle |
OmsT_Buffer_Handle |
缓冲区对象 |
index |
int |
要访问的缓冲区中元素的从 0 开始的索引 |
insertion_time_ptr |
double * |
被访问元素的插入时间,由函数填充 |
返回类型
void *
位于位置 index 的对象;若 index 无效则返回 OPC_NIL。
详细说明
该函数返回存储在缓冲区中 index 位置的元素。缓冲区的头部是索引 0,下一个元素是索引 1,依此类推。
如果索引大于或等于元素数量,或者索引为负值,则返回空指针,并且不填充 insertion_time_ptr 参数。
缓冲区中的元素数量通过 oms_buffer_num_elements_get() 函数获取。