op_esys_interface_array_get()
摘要
将向量接口的内容放入数组。
语法
op_esys_interface_array_get (interface, value_ptr, start_offset)
| 参数 | 类型 | 说明 |
|---|---|---|
interface |
Esys_Interface |
读取数据的来源 esys 接口 ID [可以通过 Topo 包和 Id 包中的若干内核过程(如 op_topo_child() 和 op_id_from_name())以及 op_intrpt_esys_interface() 获取 esys 接口 ID。] |
value_ptr |
void* |
指向接收数据的数组的指针 [该数组必须已经分配。] |
start_offset |
int |
数组中接收向量接口第一个元素的位置 |
返回类型
int
指示操作是否成功完成的完成码。
OPC_ESYS_SUCCESS 表示操作成功。关于其余的完成码,参见表 53 “External System Completion Code Symbolic Constants“ 第 13 页。
示例
/* Get values from both high and low-order data buses; concatenate into one array. */
op_ima_obj_attr_get (bus_a, "dimension", &bus_a_width);
op_ima_obj_attr_get (bus_b, "dimension", &bus_b_width);
val_array = (char *) op_prg_mem_alloc (sizeof (char) * (bus_a_width + bus_b_width));
/* First bits are placed in val_array, starting at position 0. */
op_esys_interface_array_get (bus_a, val_array, 0);
/* Remaining bits are placed starting at the bus_a_width position in val_array. */
op_esys_interface_array_get (bus_b, val_array, bus_a_width);
详情
接收向量接口内容的数组必须已经分配。当 start_offset 参数为零时,数组从其初始位置(索引 0)开始接收值。务必确保数组足够大,能够容纳向量接口中的所有值,因为该过程会依次写入连续的内存位置,直到向量接口的所有元素都被放入数组为止。
也可以通过将起始偏移参数设置为接收向量接口第一个值的数组索引编号,向数组中除初始位置以外的其他位置写入。
用途
提供一种将向量接口的内容写入指定内存位置的方法。
错误
- 程序中止:段违例。(由于数组指针参数分配不当
- 程序中止:段违例。(由于 esys 接口数据类型与数组指针不兼容
- 可恢复错误:接口句柄无效。
- 可恢复错误:试图从 esys 输出接口(
<name>)获取值。 - 可恢复错误:试图从非向量接口(
<name>)获取向量或数组值。
参考
- 使用内核过程 op_intrpt_esys_interface() 获取某个 esys 接口的接口 ID
- 使用内核过程 op_esys_interface_array_set() 将数组中的元素放置到向量接口上
- 使用内核过程 op_esys_interface_value_get() 将 esys 接口的值放入变量
- 使用内核过程 op_esys_interface_vector_get() 将向量接口中的元素放入值向量