◆ Forward() [1/2]

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

Start a monitor forward operation.

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

MTask	The task to send monitor messages too.
Action	The action to invoke in that task.
CompletedHandler	A function which is invoked when the monitor operation completes
ClientData	Passed to the handler routines
SendCurrent	Set true to send the current values of the parameters right away
count	The 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.
status	Inherited status
...	See count for details, but all are of type "const char *".