tmm_cache_entry_add()

注意: 需要地形建模模块(Terrain Modeling Module)功能。

摘要

将关于一个位置对的数据添加到缓存中,同时添加路径损耗计算的状态以及(若已计算)路径损耗的值。

语法

tmm_cache_entry_add (cache, users_entry_ptr)
参数 类型 说明
cache TmmT_Cache 要添加数据的缓存。
users_entry_ptr TmmT_Cache_Entry * 指向要添加到指定缓存的用户创建条目的指针。

返回类型

void

无返回值。

头文件

tmm.h

示例

TmmT_Cache_Entry    loss_entry;

/* prepare the key used to search the cache with */
/* our Tx/Rx positions and heights               */
loss_entry.tx_quantized_position = *tx_pos_ptr;
loss_entry.rx_quantized_position = *rx_pos_ptr;

/* Search cache for a value that has already been computed */
if (tmm_cache_entry_find (cache_ptr, &loss_entry) == OPC_FALSE)
    {

    /* Do work needed to calculate the loss */
    ...

    /* Add the newly calculated value to our cache */
    tmm_cache_entry_add (cache_ptr, &loss_entry);
    }

FRET (loss_entry.loss_value);

详情

要添加的数据应位于类型为 TmmT_Cache_Entry 的数据结构中。该结构的内容与单个缓存条目相同,如 tmm_cache_create() 的详情小节所示。

本函数复制用户的条目并将其添加到指定缓存中。

用途

本函数将一个位置对及其关联路径损耗计算的信息添加到指定缓存。该信息随后可被位于一定容差范围内的新位置复用,从而无需重新计算路径损耗。

错误

  • 指向 Entry 键数据结构的指针为 NULL。你应当使用一个缓存和一个 TmmT_Cache_Entry 的地址来调用 tmm_cache_entry_find()。

参考

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