Resets an audio unit’s render state.
- iOS 2.0+
- macOS 10.0+
- Mac Catalyst 13.0+Beta
- tvOS 9.0+
The audio unit whose render state you are resetting.
The audio unit scope, typically set to
Audio Unit Scope _Global
The audio unit element, typically set to
A result code.
This function resets the render state of an audio unit. For example, with a delay or reverb type of audio unit, it clears all of the delay lines maintained within the audio unit. Typically, you call this function when an audio unit was previously rendering and was taken out of the render chain (for example, if the track it is in gets muted) and is now being added back in (for example, unmuted). Your application should reset the audio unit before adding it back to the render chain so that it does not produce audio from its delay lines that is no longer valid.
This function clears memory. It does not allocate or free memory resources.