tmm_elev_profile_destroy()
注意: 需要地形建模模块(Terrain Modeling Module)功能。
摘要
释放由 tmm_elev_profile_get() 创建的 TmmT_Elev_Profile 数据结构。
语法
tmm_elev_profile_destroy (elev_profile_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
elev_profile_ptr |
TmmT_Elev_Profile* |
指向要销毁的高程剖面的指针 |
返回类型:
void
无返回值。
头文件
tmm.h
示例
elevation_profile_ptr = tmm_elev_profile_get (
tx_lat, tx_long, rx_lat, rx_long, TMMC_RESOLUTION_BEST);
if ((elevation_profile_ptr == OPC_NIL) ||
(elevation_profile_ptr->data_status != TmmC_Elev_Data_All_Good))
{
/* No terrain */
/* Use freespace */
power_freespace (pkptr);
}
else
{
calculate_loss (elevation_profile_ptr, tx_height, rx_height, tx_frequency);
}
tmm_elev_profile_destroy (elevation_profile_ptr);
详情
无。
用途
当 tmm_elev_profile_get() 创建的数据结构不再需要时,必须调用本函数将其释放。
错误
- 试图销毁一个无效的高程剖面。
参考
- 使用函数 tmm_elev_profile_get() 沿路径按指定间隔获取地形高度。
- 使用函数 tmm_elev_point_get() 获取指定点处的地形高度。