DynamicSoundEffectInstance.Play Method

Begins or resumes audio playback.

Namespace: Microsoft.Xna.Framework.Audio
Assembly: Microsoft.Xna.Framework (in microsoft.xna.framework.dll)

Syntax

public override void Play ()

Exceptions

Exception type	Condition
ObjectDisposedException	Exception thrown if Play is called after DynamicSoundEffectInstance is disposed.
InstancePlayLimitException	Exception thrown when the amount of concurrent DynamicSoundEffectInstance sounds playing exceeds the platform limit.
InvalidOperationException	Exception thrown when playback of the DynamicSoundEffectInstance fails.

Remarks

Play has no effect if the DynamicSoundEffectInstance object is playing currently.

Each platform has limits on the number of sounds playing simultaneously. A InstancePlayLimitException exception is thrown if this limit is exceeded. The following table shows the limits for simultaneous playing sounds based on platform.

Platform	Number of sounds that can play simultaneously
Windows Phone	64
Xbox 360	300
Windows	No limit

Silverlight applications must ensure that FrameworkDispatcher.Update is called regularly in order for "fire and forget" sounds to work correctly. Play throws an InvalidOperationException if FrameworkDispatcher.Update has not been called at least once before making this call. For more information, see Enable XNA Framework Events in Windows Phone Applications.

See Also

DynamicSoundEffectInstance Class
DynamicSoundEffectInstance Members
Microsoft.Xna.Framework.Audio Namespace

Platforms

Xbox 360, Windows 7, Windows Vista, Windows XP, Windows Phone