op_apptrack_create()
摘要
初始化应用延迟跟踪状态并创建所需文件。
语法
op_apptrack_create (dir_path_name, base_file_name)
| 参数 | 类型 | 说明 |
|---|---|---|
dir_path_name |
const char * |
存储 ADT 文件的路径(参见详情)。 |
base_file_name |
const char * |
ADT 文件的基础名称。 |
返回类型
Apptrackhandle
全局应用延迟跟踪状态;若发生错误则返回 OPC_NIL。
详情
一次仿真中只能存在一个应用延迟跟踪状态。如果该状态已由此前对该内核过程的调用初始化,后续调用将返回已有的句柄。
为了高效运行,dir_path_name 应指向磁盘上未碎片的区域。
通常,base_file_name 应为项目-场景名称,但可根据需要自定义。
用途
该内核过程初始化应用延迟跟踪状态。它还指定 ADT 文件的路径与基础名称,打开原始文件,并写出对象 ID 文件。
错误
- 可恢复错误:参数 (
dir_path_name) 为 NIL。 - 可恢复错误:参数 (
base_file_name) 为 NIL。 - 可恢复错误:目录路径名称 (
<dir_path_name>) 不是一个目录。
参考
- 不再需要应用延迟跟踪状态时,使用内核过程 op_apptrack_destroy() 将其销毁。