Mus Library Reference

MusStop()

Stop channels.

Syntax

  void MusStop(unsigned long flags, int speed);

Arguments

• flags - sound source type

• speed is the number of video frames before channels are silenced

Explanation
Stop and silence the channels processing the specified sound source type. This function allows the programmer to stop all songs, all sound effects or both within the specified amount of time, which frees the channels associated with them.

The flags argument must contain MUSFLAG_SONGS, MUSFLAG_EFFECTS or both OR'ed together.

The speed value is the number of video frames before the channels will be stopped. Any positive integer is valid. A value of zero will stop the sound handle's channels immediately.

Return Value
None

Example

  void SilenceAllSound(int frames)
  {
    MusStop(MUSFLAG_SONGS|MUSFLAG_EFFECTS,frames);
    while (MusAsk(MUSFLAG_SONGS|MUSFLAG_EFFECTS))
      CallNormalProcessing();
  }

See Also
MusAsk()
MusHandleStop()

Nintendo® Confidential Warning: all information in this document is confidential and covered by a non-disclosure agreement. You are responsible for keeping this information confidential and protected. Nintendo will vigorously enforce this responsibility. Copyright © 1998-1999 Nintendo of America Inc. All rights reserved Nintendo and N64 are registered trademarks of Nintendo Last updated March 1999