C2xTestGetWaitForMessage

Valid for: CANoe DE

Function Syntax

long C2xTestGetWaitForMessage(long &packethandle) // form 1
long C2xTestGetWaitForMessage(long index, long &packethandle) // form 2

Description

If a valid Car2x message is the last event that triggers a wait instruction, the packet’s handle can be called up with form 1. Form 2 can only be used for joined events. The number of the joined event (return value of C2xTestJoin…) is here being used as an index.

Parameters

packetHandle: A packet handle for the awaited Car2x message.
Index: Number of the joined event corresponds with the return value of C2xTestJoin….

Return Values

0: Data access successful.
-1: Data access could not be executed, the last event was not an Car2x event.

Example

long index;
long packet;
int version;

//Form 1
C2xTestWaitForMessage("CAM",1000);
C2xTestGetWaitForMessage(packet);
version = C2xGetTokenInt(packet,"geo_bh","version");

//Form 2
C2xTestJoinMessage("CAM", "Station1");
// more joined events
// ...
index = testWaitForAnyJoinedEvent(1000);
C2xTestGetWaitForMessage(index, packet);

C2xTestWaitForMessage • C2xTestJoinMessage