Ets_Topo_To_Graph()

摘要

根据给定的网络拓扑创建 PrgT_Graph 对象。

语法

Ets_Topo_To_Graph (net_model_hndl, graph_state_id, namespace, vertex_state_create_proc, edge_state_create_proc, filter_proc, state_ptr, options)
参数 类型 说明
net_model_hndl EtsT_Model_Handle 要为其创建图的网络模型的句柄
graph_state_id PrgT_Graph_State_ID 已注册的状态 ID,用于将状态附加到每个图的边和顶点
namespace char* 注册 graph_state_id 状态处理函数的命名空间名称
vertex_state_create_proc EtsT_Topo_Graph_Vertex_State_Create_Proc 一个函数,接受正在为其创建图顶点的节点的句柄以及通过 state_ptr 传入的状态,返回要附加到新顶点的状态
edge_state_create_proc EtsT_Topo_Graph_Edge_State_Create_Proc 一个函数,接受正在为其创建图边的链路的句柄以及通过 state_ptr 传入的状态,返回要附加到新边的状态
filter_proc EtsT_Topo_Graph_Filter_Proc 一个函数,接受对象句柄并返回是否应为该特定对象创建图对象
state_ptr void * 附加状态,传递给 vertex_state_create_proc 和 edge_state_create_proc,用于创建图对象状态。
options int 如何将双工链路转换为边。可取 ETSC_TOPO_CREATE_TWO_SIMPLEX_FOR_DUPLEX 或 ETSC_TOPO_CREATE_NATIVE_EDGES。详情参见 Table 42 Topology Package Symbolic Constants。

返回类型

PrgT_Graph *

网络模型的图表示

头文件

ets_api_topo.h

详情

此过程用于将网络模型的拓扑转换为 PrgT_Graph 对象。转换得到的 PrgT_Graph 对象可与 Prg 各包(如 Djk 路由包)配合使用。

此过程允许客户端指定一个附加状态,可将其附加到生成的 PrgT_Graph 的顶点(PrgT_Graph_Vertex)和边(PrgT_Graph_Edge)上。但该状态必须在调用此过程之前通过 prg_graph_state_handler_register() 预先定义,并获得一个状态 ID 作为 graph_state_id 参数传入。由于新图将在与状态处理函数相同的命名空间中创建,因此还必须传入该状态的命名空间。此外,客户端必须定义两个过程(vertex_state_create_proc 和 edge_state_create_proc),使此过程能够为每个顶点和边创建新的状态。

此外,如果客户端不想为模型中的每个对象都创建图,filter_proc 参数允许用户定义一个函数,用于决定某个对象是否应包含在图中。

三个回调参数使用以下类型定义:

typedef void*
(*EtsT_Topo_Graph_Vertex_State_Create_Proc)(EtsT_Obj_Handle obj_handle,
	PrgT_Graph_Vertex* vertex_ptr, void* state_ptr);

typedef void*
(*EtsT_Topo_Graph_Edge_State_Create_Proc) (EtsT_Obj_Handle obj_handle,
	PrgT_Graph_Edge* edge_ptr, void* state_ptr);

typedef int
(*EtsT_Topo_Graph_Filter_Proc) (EtsT_Obj_Handle obj_handle);

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