Ets_Ma_Files_Apply()

注意: 需要 OPNET Development Kit

摘要

给定一个 model assistant 文件列表和一个块名称,对所有具有指定名称的块应用处理器。

语法

Ets_Ma_Files_Apply (file_lptr, block_name, handler, state_ptr)
参数 类型 说明
file_lptr PrgT_List* model assistant 数据文件列表
block_name const char* 待处理数据的块名称
handler EtsT_Ma_Block_Handler 用于处理指定数据的处理器函数
state_ptr void* 指向对象或列表的指针。函数会将该指针传递给块处理器。

返回类型

EtsT_Compcode

头文件

ets_api_ma.h

详情

此函数提供了一种对数据块应用处理器的机制。调用此函数可将 model assistant 文件块应用到当前网络。它可以按以下方式使用:

  • 如果同时提供了 block_name 和 handler,此函数会遍历 file_list,并对所有类型为 block_name 的块应用 handler。
  • 如果提供了 block_name 但 handler 为 NULL,此函数会遍历 file_list,并对所有类型为 block_name 的块应用默认核心处理器。如果 block_name 没有定义默认处理器,此函数不做任何操作。
  • 如果提供了 handler 但 block_name 为 NULL,此函数返回一个错误,报告该输入无效。
  • 如果 handler 和 block_name 均为 NULL,此函数会对 model assistant 配置文件中列出的所有块应用默认处理器(有关该文件的更多信息,参见包概述)。如果配置文件未为某个块指定处理器,导入引擎会跳过该块。

状态指针会被传递给处理器,如 EtsT_Ma_Block_Handler 中所述。如果处理器需要引用外部对象,可以使用该参数传递指向该对象的指针。

可以为 handler 参数指定标准块处理器之一。如果调用这些处理器之一,state_ptr 参数应传入 NIL。要查看这些处理器的声明,请查阅文件 <reldir>/sys/include/ets_api.h。

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