Ets_Xml_Import()
摘要
从外部 XML 文件导入网络模型信息。
语法
Ets_Xml_Import (model_hndl, filename, postproc_func, client_data_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
model_hndl |
EtsT_Model_Handle |
指定将由通过 XML 导入的新对象填充的网络模型 |
filename |
const char * |
正在导入的 XML 文件的完整路径名。 |
postproc_func |
EtsT_Xml_Import_Postproc_Func |
后处理回调函数。该函数在导入过程完成后调用,以便对导入的模型对象做进一步更新。 |
client_data_ptr |
void * |
导入过程中仿真内核调用 postproc_func 时,传递给每次 postproc_func 调用的客户端状态指针。 |
返回类型
void
无返回值。
头文件
ets_api_xml.h
详情
Ets_Xml_Import() 允许调用方用 XML 文件描述的对象填充指定的网络模型(由 model_hndl 参数确定)。XML schema(DTD,即 Document Type Description 文件)随产品位于 <reldir>/sys/etc 目录下,文件名为 network.dtd。
调用该函数时,仿真内核读取网络的 XML 描述,并创建表示节点、链路、注释、需求等的对象。由 model_hndl 标识的模型的内容会被 XML 文件中描述的对象替换——导入前已存在的对象不会保留。
导入过程首先创建一个"骨架",生成原始的节点、链路、需求、路径、注释和子网对象。骨架创建完成后,可以通过后处理回调为模型中的对象附加额外信息。
后处理回调函数会对模型中创建的每个对象调用一次。该函数可以执行所需的任何额外工作来充实该对象。后处理函数的原型见 EtsT_Xml_Import_Postproc_Func。
默认的后处理函数是 Nt_Xmli_Postproc_Default()。它设置对象上的所有属性值,并设置子网网格与边界。