NNS_SndPlayerSetInitialVolume

Syntax

#include <nnsys/snd.h>

void NNS_SndPlayerSetInitialVolume(
        NNSSndHandle* handle,
        int volume );

Arguments

`handle`	The sound handle pointer.
`volume`	Initial volume value. Takes a value between 0 and 127.

Return Values

None.

Description

Sets the initial volume value of the sequence.

This function sets the initial volume value of the sequence bound to the sound handle, handle. This function does not perform any action if the stream handle is invalid.

The default value for volume is the maximum of 127. This value affects all sequence tracks.

Note

This function is called inside of the NNS_SndArcPlayerStartSeq* function and the NNS_SndArcPlayerStartSeqArc* function. If this function is called again, the set values will be overwritten. To avoid overwriting these values, use a function such as NNS_SndPlayerSetVolume.

Revision History

2004/06/01 Initial version.