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

## MusFxBankNumberOfEffects()

Get the number of sound effects in a sound effect bank.

Syntax

      int MusFxBankNumberOfEffects(void *ifxbank);

Arguments

- ifxbank is the address of an initialized sound effect bank

Explanation
Get the number of sound effects stored in the specified initialized sound effect bank. When starting sound effects using a sound effect bank, the valid range is 0 to MusFxBankNumberOfEffects() -1 inclusive.

The ifxbank must contain the address of a sound effect bank initialized with the MusFxBankInitialize() function.

Return Value
Number of sound effects in the specified sound effect bank.

Example

      musHandle AudioStartEffect(void *fxbank, int number)
      {
        musHandle handle;

        if (number>=MusFxBankNumberOfEffects(fxbank))
          return (0); /* failure! */
        MusFxBankSetSingle(fxbank);
        handle = MusStartEffect(number);
        return (handle);
      }

See Also
MusFxBankInitialize()

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