CLC_ErrorCode Controller_SendDown

(

CPHOBJECT const

hController

)

Send the message related to the button down action, if any. If the controller has been assigned with a selector:

• if a value down has been specified, the related message is sent.
• if no value down has been set, a selector with value 1 is sent. If the controller has been assigned with a modifier:
• if a value down has been specified, the related message is sent.
• if no value down has been set, a modifier with value 0xFFFF is sent.

  Parameters

  [in]

  hController

  Controller handle

  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.