CLC_ErrorCode Controller_SendValue	(	CPHOBJECT const	hController,
		CPUINT16 const	wValue,
		ControllerSendModes const	mode
	)

Send a value using the assigned message. If the assigned message is a Selector, the value is sent in proportional mode (see SelectorMessage_SetProportionalValue)

Parameters

[in]	hController	Controller handle
[in]	wValue	the full range value [0..0xFFFF]
[in]	mode	tells if the value is absolute, relative (simple cast to CPINT16) or proportional (only for Selectors)

Remarks

If some destination is not yet validated, the method returns ERR_SentToNotYetValidatedDestination. The message delivery is not guaranteed for those destinations.

Returns

Standard CHAILink Client return code. See CLC_ErrorCode enumeration.

Warning

This function can only be called in CopperLan context. This means in the pseudo task CPDoProcess(), in notification handlers or in asynchronous return handlers and not in SystemDoProcess() for instance.