Skip to main content

​
TestJoinMessageEvent

Valid for: CANoe DE • CANoe4SW DE

​
Function Syntax

  • long TestJoinMessageEvent (dbMsg aMessage)
  • long TestJoinMessageEvent (dword aMessageId)

​
Description

Completes the current set of “joined events” with the transmitted event. This function does not wait. Note: Dependent on the used parameter type the appropriate bus context in a multibus environment has only to be set before the function is called if the corresponding database object will be ambiguous. Further information on site MultiBus Environment.

​
Parameters

  • aMessage: Message that should be awaited.
  • aMessageId: Numeric ID of the message for which should be waited.

​
Return Values

  • -3: Join error
  • -1: General error, for example, functionality is not available
  • > 0: Number of the joined event

​
Example

// add msg event to the current set of "joined events" and fill the msg data to message ‘eventMessage’
dword index = 0;
TestJoinMessageEvent(VehicleMotion);
// ... other join events
TestJoinEnvVarEvent(MyEnvVar);
TestJoinSignalInRange(Velocity, 80, 100);
TestJoinTextEvent("ErrorFrame occurred!");

index = TestWaitForAnyJoinedEvent(2000);

TestGetWaitEventMsgData(index, eventMessage);
TestWaitForMessage • TestGetWaitEventMsgData • TestWaitForAnyJoinedEvent • TestWaitForAllJoinedEvents