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);