AAO DRAMA C++ Interface (Old style)
DRAMA C++, Depreciated, don't use for new code

◆ Forward() [2/2]

void DcppMonitor::Forward ( const char *const  MTask,
const char *const  Action,
const DcppHandlerRoutine  StartedHandler,
const DcppHandlerRoutine  CompletedHandler,
const DcppVoidPnt  ClientData,
const bool  SendCurrent,
const int  count,
StatusType *const  status,
  ... 
)

Start a monitor forward operation, with started handler.

This method causes a monitor message to be sent to the task indicating parameter change messages should be sent to the specified task. If status is ok on return, then the action/UFACE context should reschedule to handle the messages. It should invoked DcppDispatch() to disptach messages to the handler routines.

Parameters
MTaskThe task to send monitor messages too.
ActionThe action to invoke in that task.
StartedHandlerA function which is invoked when the monitor has started.
CompletedHandlerA function which is invoked when the monitor operation completes
ClientDataPassed to the handler routines
SendCurrentSet true to send the current values of the parameters right away
countThe number of parmeters to monitor. If negative, then there is only one more argument after status and it is a char * string containing a list of parameter names. If zero, then no parameters are to be monitored (through the transactions is started. If postive, then we have that number of extra arguments after status which are the names of parameters to be monitored.
statusInherited status
...See count for details, but all are of type "const char *".