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。