CPXXsettuningcallbackfunc 和 CPXsettuningcallbackfunc
修改用户编写的传统回调函数,以便在调整过程中每次试运行前调用。
int 'CPXXsettuningcallbackfunc'('CPXENVptr' '环境',' 'int( 'CPXPUBLIC'*' '回调)(CPXCENVptr, void *, int, void *) ', void *' 'cbhandle')
int 'CPXsettuningcallbackfunc'('CPXENVptr' '环境',' 'int( 'CPXPUBLIC'*' '回调)(CPXCENVptr, void *, int, void *) ', void *' 'cbhandle')
描述
例程 "CPXXsettuningcallbackfunc/CPXsettuningcallbackfunc修改用户编写的传统回调函数,以便在调整过程中每次试运行前调用。
此例程属于遗留回调。 请勿将此例程用于应用程序中通用回调。 有关通用回调的更多信息,请参阅《CPLEX 用户手册》中的 "通用回调"主题。
Callback 描述
int CPXPUBLIC
callback (CPXCENVptr env,
void *cbdata,
int wherefrom,
void *cbhandle);
这是用户编写的回调例程。
回调返回值
非零则终止调谐。
回调自变量
env
指向传入相关调整例程的 CPLEX 环境的指针。
cbdata
从调谐例程传递到用户编写的回调函数的指针,该函数包含有关调谐过程的信息。 cbdata 指针的唯一用途是将其传递到例程 CPXXgetcallbackinfo/CPXgetcallbackinfo。
wherefrom
整数值,指定用户编写的回调函数是从哪个存储过程中调用的。 对于此回调,该值始终为 "CPX_CALLBACK_TUNING。
cbhandle
指向用户私人数据的指针,与传递给 "CPXXsettuningcallbackfunc/CPXsettuningcallbackfunc的数据相同。
参数
- env
一个指向
CPXXopenCPLEX/CPXopenCPLEX所返回 CPLEX 环境的指针。- callback
一个指向用户编写的回调函数的指针。 将 "
callback设置为 NULL 可以防止在调整过程中调用任何回调函数。 调用 "callback会在每次调整试运行前进行。 该函数由用户编写,其原型已在此处记录。- cbhandle
一个指针,指向用户专用数据。 此指针将传递到回调函数。
返回
如果此例程成功,那么会返回 0,而如果发生错误,那么会返回非零。示例
status = CPXsettuningcallbackfunc (env, myfunc, NULL);