op_stat_local_read()

摘要

从外围处理器或队列的输入统计量读取当前值。

语法

op_stat_local_read (instat_index)
参数 类型 说明
instat_index int 目标输入统计量的数字索引
[输入统计量索引限定在 0 到 99 的范围内。]

返回类型

double

指定输入统计量的当前值。若发生可恢复错误,返回常量 OPC_DBL_INVALID。

示例

摘自:示例模型(models/std/eth_net);进程模型(eth_mac);头文件块。

/*** mnemonic macros for transitions and executives ***/
#define DEFERENCE_ON	     (op_stat_local_read (DEFERENCE_INSTAT) == 1.0)
#define DEFERENCE_OFF	    (op_stat_local_read (DEFERENCE_INSTAT) == 0.0)

#define DEFERENCE_LOW    (op_intrpt_type () == OPC_INTRPT_STAT && \
                        op_intrpt_stat () == DEFERENCE_INSTAT && \
                        DEFERENCE_OFF)

#define COLL_DET_HIGH    (op_intrpt_type () == OPC_INTRPT_STAT && \
                        op_intrpt_stat () == TRANSMITTING_INSTAT && \
                        op_stat_local_read (TRANSMITTING_INSTAT) == 0.0)

详情

该内核过程可以随时读取输入统计量;它返回写入相连统计量连线的最后一个值。如果指定输入统计量没有连接统计量连线,或输入统计量索引超出范围,则发生错误并返回常量 OPC_DBL_INVALID。

用途

提供一种获取输入统计量值的机制;输入统计量的值即另一个模块输出统计量的值,通过相连的统计量连线传递。该内核过程可用于两种模式:

  • 外围模块因统计量连线中断而被中断,该中断表示连线上发生了相关变化,进程读取输入统计量以确定更新后的值。
  • 外围模块自行决定需要对某条统计量连线的值进行采样,以便在计算中使用该值。

错误

  • 程序中止(Program Abort):该内核过程需要进程上下文。
  • 可恢复错误(Recoverable Error):局部统计量索引(<stat_index>)超出范围。
  • 可恢复错误(Recoverable Error):模块没有相连的统计量输入。
  • 可恢复错误(Recoverable Error):输入统计量索引(<stat_index>)未被占用。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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