CHAILink SDK  Version 1.3
All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
CLC_ErrorCode Controller_SendValueWithAutomation ( CPHOBJECT const  hController,
CPUINT16 const  wValue,
ControllerSendModes const  mode,
CPBOOLEAN const  fWriteToEnd,
CPBOOLEAN const  fTouch,
PerformanceMessageAutomationStates const  state 
)

Send a value using the assigned message, specifying automation The value is sent in proportional mode (see SelectorMessage_SetProportionalValue) if the assigned message is a Selector and if the value is not relative.

Parameters
[in]hControllerController handle
[in]wValuethe full range value [0..0xFFFF]
[in]modetells if the value is absolute, relative (simple cast to CPINT16) or proportional (only for Selectors)
[in]fWriteToEndFALSE: Latch mode, TRUE: Write to End mode
[in]fTouchFALSE: No touch, TRUE: touch
[in]statesee PerformanceMessageAutomationStates
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.