# null

# TestGetWaitLinLongDominantSignalData

[Valid for](../../../Shared/FeatureAvailability.md): CANoe DE • CANoe4SW DE

## Function Syntax

```
long TestGetWaitLinLongDominantSignalData (linLongDominantSignal apEvent);
```

```
long TestGetWaitLinLongDominantSignalData (dword index, linLongDominantSignal apEvent);
```

## Description

If LIN LongDominantSignal is the last event that triggers a wait instruction, the frame content can be called up with the first function.

The second function can only be used for **joined events**. The number of the **joined event** (return value of `testJoin...`) is here being used as an index.

## Parameters

* **apEvent**: Event variable that should be filled in with this function.
* **index**: Number of the **joined event** corresponds with the return value of `testJoin...`.

## Return Values

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

## Example

```c
testcase tcTFS_linLongDominantSignal ()
{
   linLongDominantSignal linLongDominantSignal;
   if (testWaitForLinLongDominantSignal (5000) == 1)
   {
      if (testGetWaitLinLongDominantSignalData(linLongDominantSignal) == 0)
      {
         testStep("Evaluation", "LIN LongDominantSignal event occurred. Signal length is %d ns", linLongDominantSignalData.length_ns);
      }
   }
}
```

[TestWaitForLinLongDominantSignal](CAPLfunctionTestWaitForLinLongDominantSignal.md) • [TestJoinLinLongDominantSignal](CAPLfunctionTestJoinLinLongDominantSignal.md)
