# NNS_SndWaveOutSetVolume

## C Specification

      #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 to the waveform playback handle of the waveform that is being 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

10/19/2004 Added a note on calling this function.

07/01/2004 Initial version.