> ## Documentation Index
> Fetch the complete documentation index at: https://notevil.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# CAPLfunctionIso11783ILOPControlAudio

[Open topic with navigation](../../../../../../CANoeDEFamily.htm#Topics/CAPLFunctions/ISO11783/ISOInteractionLayer/Functions/CAPLfunctionIso11783ILOPControlAudio.md)

**CAPL Functions** » **ISO11783** » **ISO11783 Interaction Layer** » Iso11783IL\_OPControlAudio

# Iso11783IL\_OPControlAudio

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

## Function Syntax

```plaintext theme={null}
long Iso11783IL_OPControlAudio( dword activations, dword frequency, dword onTime, dword offTime ); // form 1
long Iso11783IL_OPControlAudio( dbNode implement, dword activations, dword frequency, dword onTime, dword offTime ); // form 2
```

## Description

The function plays an acoustic signal on the Virtual Terminal. A **Control Audio Device** command is sent to the Virtual Terminal.

## Parameters

* **activations**: number of tones
* **frequency**: frequency in \[Hz]
* **onTime**: duration of the tone in \[ms]
* **offTime**: duration of the gaps between the tones
* **implement**: Simulation node to apply the function.

## Return Values

* **0**: function has been executed successfully
* **\< 0**: an error has occurred, see [error codes](../../../CAPLfunctionsISOj1939ErrorCodes.md)

## Example

```plaintext theme={null}
Iso11783IL_OPControlAudio( 2, 2000, 100, 50 );
```
