---
title: "MusicTrackNewUserEvent(_:_:_:)"
framework: audiotoolbox
role: symbol
role_heading: Function
path: "audiotoolbox/musictracknewuserevent(_:_:_:)"
---

# MusicTrackNewUserEvent(_:_:_:)

Adds an event of type MusicEventUserData to a music track.

## Declaration

```swift
func MusicTrackNewUserEvent(_ inTrack: MusicTrack, _ inTimeStamp: MusicTimeStamp, _ inUserData: UnsafePointer<MusicEventUserData>) -> OSStatus
```

## Parameters

- `inTrack`: The music track to add the event to.
- `inTimeStamp`: The timestamp, in beats, at which to add the event. Must be greater than or equal to 0.
- `inUserData`: The event to add to the music track.

## Return Value

Return Value A result code.

## See Also

### Managing Music Tracks

- [MusicTrackClear(_:_:_:)](audiotoolbox/musictrackclear(_:_:_:).md)
- [MusicTrackCopyInsert(_:_:_:_:_:)](audiotoolbox/musictrackcopyinsert(_:_:_:_:_:).md)
- [MusicTrackCut(_:_:_:)](audiotoolbox/musictrackcut(_:_:_:).md)
- [MusicTrackGetDestMIDIEndpoint(_:_:)](audiotoolbox/musictrackgetdestmidiendpoint(_:_:).md)
- [MusicTrackGetDestNode(_:_:)](audiotoolbox/musictrackgetdestnode(_:_:).md)
- [MusicTrackGetProperty(_:_:_:_:)](audiotoolbox/musictrackgetproperty(_:_:_:_:).md)
- [MusicTrackGetSequence(_:_:)](audiotoolbox/musictrackgetsequence(_:_:).md)
- [MusicTrackMerge(_:_:_:_:_:)](audiotoolbox/musictrackmerge(_:_:_:_:_:).md)
- [MusicTrackMoveEvents(_:_:_:_:)](audiotoolbox/musictrackmoveevents(_:_:_:_:).md)
- [MusicTrackNewAUPresetEvent(_:_:_:)](audiotoolbox/musictracknewaupresetevent(_:_:_:).md)
- [MusicTrackNewExtendedNoteEvent(_:_:_:)](audiotoolbox/musictracknewextendednoteevent(_:_:_:).md)
- [MusicTrackNewExtendedTempoEvent(_:_:_:)](audiotoolbox/musictracknewextendedtempoevent(_:_:_:).md)
- [MusicTrackNewMIDIChannelEvent(_:_:_:)](audiotoolbox/musictracknewmidichannelevent(_:_:_:).md)
- [MusicTrackNewMIDINoteEvent(_:_:_:)](audiotoolbox/musictracknewmidinoteevent(_:_:_:).md)
- [MusicTrackNewMIDIRawDataEvent(_:_:_:)](audiotoolbox/musictracknewmidirawdataevent(_:_:_:).md)