waveOutReset(3mms) — Subroutines
Name
waveOutReset --- Stop audio playback and reset current position
Syntax
#include <mme/mme_api.h>
MMRESULT waveOutReset(HWAVEOUT hWaveOut)
Arguments
HWAVEOUT hWaveOut
Specifies a handle to a waveform audio output device.
Description
The waveOutReset function stops playback on a specified waveform audio output device and resets the current position to 0. All pending playback buffers are marked as done and returned to the application via the callback defined in the waveOutOpen function.
Before attempting to close a waveform audio outout device, call the waveOutReset function to mark all pending buffers as done. Then, call the waveOutClose function to close the device.
Extensions
None.
Return Values
Returns MMSYSERR_NOERROR if the function is successful; otherwise, it returns one of the following error codes:
MMSYSERR_INVALHANDLE@T{ The specified device handle is invalid. T} MMSYSERR_HANDLEBUSY@T{ The handle hWaveOut is in use on another thread. T}