Esa_Execute_Until()

摘要

使仿真能够处理若干事件。

语法

Esa_Execute_Until (esa_state_ptr, status_ptr, until, execute_flags, time_reached_ptr, num_events_ptr)
参数 类型 说明
esa_state_ptr EsaT_State_Handle 由 Esa_Init() 生成的 ESA 状态信息
status_ptr int * 用于填入相应状态值的区域(参见详情)
until double 本次调用的仿真时间上限,或使用 ESAC_TIME_MAX 运行至结束
execute_flags int 以下选项的组合
- ESAC_UNTIL_EXCLUSIVE——执行到仿真时间达到 until 值为止,但在执行该时间的事件之前返回。
- ESAC_UNTIL_INCLUSIVE——执行到仿真时间达到 until 值为止,包括为该时间预定的事件。
- ESAC_UNTIL_ONE_EVENT——最多执行一个事件。
time_reached_ptr double * 该函数返回后的仿真时间
num_events_ptr int * 已执行的事件数

返回类型

EsaT_Compcode

若仿真按规定执行则为 EsaC_Comp_Success,否则为 EsaC_Comp_Failure。

头文件

esa.h

详情

该函数使联合仿真能够让 Riverbed Modeler 仿真处理一组预定事件,然后再将控制权交还给联合仿真代码。

在联合仿真中,Riverbed Modeler 仿真分若干片段执行(每次执行少量事件)。该函数使联合仿真能够控制这些片段的大小。

调用该函数后,Riverbed Modeler 仿真将持续执行,直到出现下列条件之一(并将相应值写入 *status_ptr):

  • execute_flags 为 ESAC_UNTIL_EXCLUSIVE,且仿真时间大于或等于 until [*status_ptr 被设置为 ESAC_STATUS_DURATION]
  • execute_flags 为 ESAC_UNTIL_INCLUSIVE,且仿真时间大于 until,或时间等于 until 且该时间已无预定事件 [*status_ptr 被设置为 ESAC_STATUS_DURATION]
  • execute_flags 为 ESAC_UNTIL_EXCLUSIVE | ESAC_UNTIL_ONE_EVENT,且已执行一个事件,或仿真时间大于或等于 until [*status_ptr 被设置为 ESAC_STATUS_DURATION]
  • execute_flags 为 ESAC_UNTIL_INCLUSIVE | ESAC_UNTIL_ONE_EVENT,且已执行一个事件,或仿真时间大于 until [*status_ptr 被设置为 ESAC_STATUS_DURATION]
  • 不再有预定事件 [*status_ptr 被设置为 ESAC_STATUS_DURATION]
  • 仿真终止(超出仿真时长、执行了 op_sim_end(),或遇到致命错误) [*status_ptr 被设置为 ESAC_STATUS_TERMINATION]
  • 接口回调调用了 Esa_Interrupt()(在这种情况下,函数将在调用 Esa_Interrupt() 的那个事件执行完毕后返回) [*status_ptr 被设置为 ESAC_STATUS_EXTERNAL]
  • 在 Riverbed 分析软件事件执行期间调用了 Esa_Interrupt() [*status_ptr 被设置为 ESAC_STATUS_INTERRUPTED]
  • ESA 包未通过 Esa_Load() 加载 [*status_ptr 被设置为 ESAC_STATUS_PACKAGE_CLOSED]

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