cyber_effects_cmd_process()
摘要
在客户端模块中处理并执行某个效应。
语法
cyber_effects_cmd_process (mgr_ptr, client_mem_vptr, intrpt_code)
| 参数 | 类型 | 说明 |
|---|---|---|
mgr_ptr |
CyberT_Effect_Mgr* |
所关注的 cyber-effects manager。该句柄可通过调用 cyber_effects_mgr_handle_get() 获取。 |
client_mem_vptr |
void* |
指向客户端数据的指针,其中包含供该效应使用并可能被效应修改的当前模块信息。该指针作为 model_data_vptr 参数传递给 CyberT_Effect_Proc_Ptr 效应回调。 |
intrpt_code |
int |
当前中断代码。用于判断该效应应被执行(正值)还是被取消(负值)。 |
返回类型
void
无返回值
头文件
cyber_effects.h
示例
来自 ip_rte_central_cpu 进程模型:
状态变量:
double one_over_service_rate; /* Number of packets handled by routing processor per second */
CyberT_Effect_Mgr* effects_mgr_ptr; /* Handle to the Cyber-Effects Manager */
header block:
compound_objid = op_topo_child (ip_proc_info_objid, OPC_OBJTYPE_GENERIC, 0);
/* Get assigned value of server processing rate. */
return_status = op_ima_obj_attr_get (compound_objid, "Datagram Forwarding Rate", &service_rate);
if (return_status == OPC_COMPCODE_FAILURE)
ip_rte_cpu_error ("Unable to get server datagram forwarding rate from attribute.");
/* Store 1/service rate to avoid doing division each time */
one_over_service_rate = 1.0 / service_rate;
effects_mgr_ptr = cyber_effects_mgr_handle_get();
function block:
void ip_rte_central_cpu_cyber_effect_cmd_process (int intrpt_code)
{
void* client_mem_ptr = OPC_NIL;
/** Local function that process interrupts sent by the cyber_effect_mgr, **/
/** requesting the execution of a Cyber Effect. **/
FIN (ip_rte_central_cpu_cyber_effect_cmd_process (intrpt_code));
if (cyber_effects_intrpt_code_eval(CMD_INTRPT_CODE_CHANGE_FWD_RATE,intrpt_code))
client_mem_ptr = &one_over_service_rate;
if (client_mem_ptr != OPC_NIL)
cyber_effects_cmd_process (effects_mgr_ptr, client_mem_ptr, intrpt_code);
FOUT;
}
详细说明
当注册了某个效应的客户端模块收到来自 cyber-effects manager 的、表明该效应已到期应执行的中断时,会调用此函数。该函数从中断的事件状态获取该效应的详细信息,并调用该效应对应的执行或取消过程。