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>)获取向量或数组值。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com