定义自定义效应

要定义自定义效应,你必须编写处理网络中断、实现该效应及其相关操作(例如取消效应)的 C/C++ 代码。这些函数可以添加到进程模型的功能块中,或作为外部文件包含。

每个涉及网络效应的文件都必须包含下面这一行

#include "cyber_effects.h"

你需要将对 Cyber Effects 模型的添加内容写入 cyber_effects.h,包括:

  • 效应与参数名称
  • 参数结构

你创建的任何新类别、效应和参数都必须包含在 cyber_effects.h 中相应的数据结构里。例如,对于 IP 类别中的一个新效应,必须在枚举类型 CyberT_Effects_IP 中添加新成员。你应当在每个结构中的“count”变量之前添加新成员。你可能需要覆盖结构中的默认索引,以匹配你将在配置节点中分配的符号映射值;详情参见更新 Cyber Effects 配置节点中的讨论。

你应当将该效应及相关操作实现为遵循以下原型的回调

typedef void (*CyberT_Effect_Proc_Ptr) (CyberT_Cmd_Iface* cmd_iface_ptr, void* effect_args_vptr, void* model_data_vptr);

每个回调都会在进程模型中做出更改以产生期望的行为,如 CyberT_Effect_Proc_Ptr 原型详情中所述。

支持网络建模的进程都会有一个处理网络事件中断的函数。当收到来自 CEM 的中断时,客户端模块可以通过调用 cyber_effects_cmd_process() 函数执行相应的效应。该函数需要三个参数:CEM 的句柄、指向客户端本地数据结构的指针(该结构提供客户端的当前信息以及与效应相关的内存,即 client_mem_vptr),以及中断代码。你需要添加代码以正确设置 client_mem_vptr。

cyber_effects_cmd_process() 函数会在内部从中断事件获取更多信息,并执行为相应事件定义的 CyberT_Effect_Proc_Ptr 回调。client_mem_vptr 将作为 model_data_vptr 传递给效应回调。这一做法的示例可以在 ip_rte_central_cpu_cyber_effect_cmd_process() 函数中找到,该函数位于 ip_rte_central_cpu 进程模型的功能块中。