AudioPlayerAgent.OnError Method

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Called when there is an error with playback, such as an audio track not downloading correctly.

Namespace: Microsoft.Phone.BackgroundAudio
Assembly: Microsoft.Phone (in Microsoft.Phone.dll)


Protected Overridable Sub OnError ( _
    player As BackgroundAudioPlayer, _
    track As AudioTrack, _
    error As Exception, _
    isFatal As Boolean _
protected virtual void OnError(
    BackgroundAudioPlayer player,
    AudioTrack track,
    Exception error,
    bool isFatal


  • isFatal
    Type: System..::.Boolean
    If true, playback cannot continue and playback of the track stops.


This method is not guaranteed to be called in all cases. For example, if the background agent itself has an unhandled exception, it does not get called back to handle its own errors.

If you don’t override the OnError(BackgroundAudioPlayer, AudioTrack, Exception, Boolean) method, then it simply calls Abort()()() if the value of isFatal is true; otherwise, it simply calls NotifyComplete()()().


This API is not supported for Silverlight 8.1 apps.

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1


Windows Phone

See Also


AudioPlayerAgent Class

Microsoft.Phone.BackgroundAudio Namespace