# NNS_SndWaveOutSetVolume

## Syntax

      #include <nnsys/snd.h>

      void NNS_SndWaveOutSetVolume(
              NNSSndWaveOutHandle handle,
              int volume );

## Arguments

`handle` | Waveform playback handle.
`volume` | The volume. Takes a value between 0 and 127.

## Return Values

None.

## Description

Changes the volume of the waveform playback. If this function is called for the waveform playback handle of a waveform that is stopped, it does not do anything.

This function is called to change volume during play. Use an argument in the `NNS_SndWaveOutStart` function to set the volume that will be used when play commences.

## See Also

NNS_SndWaveOutStart

## Revision History

2004/10/19 Added a note on calling this function.
2004/07/01 Initial version.

CONFIDENTIAL