{{DISPLAYTITLE:_SNDPAUSE}}
The [[_SNDPAUSE]] statement pauses a sound using a handle from the [[_SNDOPEN]] function.


{{PageSyntax}}
::: [[_SNDPAUSE]] {{Parameter|handle&}}


{{PageDescription}}
* Sound must be playing or statement will not do anything!
* Continue playing by calling [[_SNDPLAY]]
* Sound files opened must have the "PAUSE" capability to use this statement and '''still may not pause'''.
* '''Calling _SNDPAUSE again will not continue playing!'''

{{TextStart}}    QB64 supports the following sound file formats ('''Bold is a guaranteed capability'''):

             WAV = "'''VOL,SYNC,LEN''',PAUSE"      [http://www.rarewares.org/ogg-oggdropxpd.php Free WAV to OGG GUI converter]
             OGG = "VOL,SYNC,LEN,PAUSE"      [http://www.rarewares.org/ogg-oggenc.php Free WAV to OGG converter]
             AIF = "VOL,SYNC,LEN,PAUSE"
             RIF = "VOL,SYNC,LEN,PAUSE"
             VOC = "VOL,SYNC,LEN,PAUSE"
             MID = "'''VOL'''"
             MOD = "VOL,PAUSE"
             MP3 = "'''VOL''',PAUSE,SETPOS"        [http://www.freemp3wmaconverter.com/index.html Free WMA, MP3 and OGG converter]

        ''Note:'' {{Cb|_SNDBAL}} only affects MP3 volume. Sound will reside in main channel.
{{TextEnd}}


''Example:''
{{CodeStart}} '' ''
{{Cl|_SNDPAUSE}} h& '' ''
{{CodeEnd}}


{{PageSeeAlso}}
* [[_SNDPLAY]], [[_SNDSTOP]]
* [[_SNDPAUSED]]


{{PageNavigation}}