N64® Functions Menu

al - Audio Library Functions
gDP - DP GBI Macros
gdSP - General GBI Macros
gSP - SP GBI Macros
gt - Turbo Microcode RDP
gu - Graphics Utilities
Math - Math Functions
Mus - Mus Library
nuSys - NuSystem
os - N64 Operating System
sp - Sprite Library Functions
uh - Host to Target IO
64DD - N64 Disk Drive

Nintendo® Confidential

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