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
nuSys - NuSystem
os - N64 Operating System
sp - Sprite Library Functions
uh - Host to Target IO
64DD - N64 Disk Drive

Nintendo® Confidential

## n_alInit

Syntax

    #include <n_libaudio.h>
    void    n_alInit(N_ALGlobals *globals, ALSynConfig *c);

Arguments

- globals is the pointer to the N_ALGlobals structure
- c is the pointer to the Synthesis Driver configuration structure

Explanation
This function is available in the n_audio library. To use the n_audio library, you must first call this function to initialize a Synthesis driver with the configuration specified by c and to initialize the n_audio library global variables.
Configuration Structure
The configuration structure includes these members:

- maxVVoices is maximum number of virtual voices to allocate
- maxPVoices is the maximum number of physical voices to allocate
- maxUpdates is the maximum number of synthesizer updates to allocate
- maxFXBusses is the maximum number of effects busses to allocate
- dmaproc is the pointer to the Audio DMA callback initialization routine, which is called once for each physical voice and must return a pointer to the ALDMAproc that the voice will use when requesting a direct memory access (DMA) of audio samples
- heap is the pointer to an ALHeap structure that has been already been initialized by a call to the alHeapInit function
- outputRate is the desired hardware output rate (22k, 32k, or 44.1k)
- fxType is the desired effects type
- params is the pointer to the parameter list to use when constructing a custom effects chain.

See Also
n_alClose
alHeapInit

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
Nintendo of America Inc. All rights reserved
Nintendo and N64 are registered trademarks of Nintendo
Last Updated April, 1999