waveOutReset function (mmeapi.h)
The waveOutReset function stops playback on the given waveform-audio output device and resets the current position to zero. All pending playback buffers are marked as done (WHDR_DONE) and returned to the application.
Syntax
MMRESULT waveOutReset(
HWAVEOUT hwo
);
Parameters
hwo
Handle to the waveform-audio output device.
Return value
Returns MMSYSERR_NOERROR if successful or an error otherwise. Possible error values include the following.
| Return code | Description |
|---|---|
|
Specified device handle is invalid. |
|
No device driver is present. |
|
Unable to allocate or lock memory. |
|
Specified device is synchronous and does not support pausing. |
Remarks
After this function returns, the application can send new playback buffers to the device by calling waveOutWrite, or close the device by calling waveOutClose.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | mmeapi.h (include Windows.h) |
| Library | Winmm.lib |
| DLL | Winmm.dll |