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]