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()。
参考
- 使用函数 tmm_cache_create() 创建新缓存。
- 使用函数 tmm_cache_destroy() 销毁指定的缓存。
- 使用函数 tmm_cache_entry_find() 搜索 TmmT_Cache 数据结构,若存在指定位置对的路径损耗则返回。