prg_djk_path_consider_proc_register()
摘要
注册一个在考察路径时被调用的过程。
语法
prg_djk_path_consider_proc_register (graph_ptr, path_consider_proc, client_state_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
graph_ptr |
PrgT_Graph * |
要为其注册路径考察回调及关联客户状态的图。 |
path_consider_proc |
PrgT_Djk_Consider_Proc |
要注册的回调过程。 |
client_state_ptr |
void * |
任意的客户状态,每次调用 path_consider_proc 回调时都会传入。 |
返回类型
void
无返回值。
头文件
prg_djk.h
详情
此函数将路径考察过程与指定的图关联。当某条路径或部分路径正被考察是否作为当前最短路径时,会调用该路径考察过程。路径考察过程可用于评估该路径是否合法。它可以访问当前工作路径中的所有跳以及客户状态,以便做出判断。
注意: 即使已注册,除非调用 prg_djk_path_get_options() 并带有 PRGC_DJK_PATH_GET_OPT_CONSIDER_PATH 选项,否则路径考察过程不会被使用。函数 prg_djk_path_get() 不会调用路径考察过程。
回调原型见 PrgT_Djk_Path_Consider_Proc。