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