waveOutClose(3mms) — Subroutines
Name
waveOutClose --- Close the specified waveform audio output device
Syntax
#include <mme/mme_api.h>
MMRESULT waveOutClose(HWAVEOUT hWaveOut)
Arguments
HWAVEOUT hWaveOut
Specifies a handle to a waveform audio output device. If the function is successful, the handle is no longer valid after this call.
Description
The waveOutClose function closes the specified waveform audio output device. If the device is still playing a waveform, the close operation fails.
To ensure a successful close operation, 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} WAVERR_STILLPLAYING@T{ There are buffers still in the queue. T}