waveOutPause

Syntax

WORD waveOutPause(hWaveOut)

This function pauses playback on a specified waveform output device. The current playback position is saved. Use waveOutRestart to resume playback from the current playback position.

Parameters

HWAVEOUT hWaveOut

Specifies a handle to the waveform output device.

Return Value

Returns zero if the function was successful. Otherwise, it returns an error number. Possible error returns are:

MMSYSERR_INVALHANDLE

Specified device handle is invalid.

Comments

Calling this function when the output is already paused has no effect, and the function returns zero.

See Also

waveOutRestart, waveOutBreakLoop