Skip to main content

​
TestWaitForChangeCountGreater

Valid for: CANoe DE • CANoe:lite DE • CANoe4SW DE • CANoe4SW:lite DE

​
Function Syntax

long TestWaitForChangeCountGreater(valueHandle * value, qword count, dword timeoutMs);

​
Description

Waits for the change counter of a valueHandle to reach a certain value. Each valueHandle contains a change counter which is reset to 0 at the start of measurement and with explicit calls to valueHandle::ResetValueState. You can read out the counter with valueHandle::GetChangeCount. In case of a distributed object, this functionality is only available if the [EnableChangeInfo] attribute is enabled for the respective object.

​
Parameters

  • value: Value handle of a communication object or distributed object.
  • count: Change count to be reached.
  • timeoutMS: Maximum time that should be waited [ms]. Transmission of 0: no timeout controlling.

​
Return Values

  • -2: Resume due to constraint violation
  • -1: General error, for example, functionality is not available
  • 0: Resume due to timeout
  • 1: Resume due to event occurred (value has changed)

​
Example

long ret;
consumedEventRef * anEvent;
anEvent = lookupConsumedEvent(path);
// ...
ret = testWaitForChangeCountGreater(anEvent, anEvent.GetChangeCount() + 3, 200);
Programming with the Communication Concept (C#, Python and CAPL) • TestWaitForChangeFlag • TestWaitForChange • TestWaitForUpdateCountGreater