Name

 
waveInReset --- Stop audio recording and reset current position
 
 

Syntax

 #include <mme/mme_api.h>
 MMRESULT waveInReset(HWAVEIN hWaveIn)
 

Arguments

 
HWAVEIN hWaveIn
Specifies a handle to a waveform audio input device.
 
 

Description

 
The waveInReset function stops input on the specified waveform audio input device and resets the current position to 0.  All pending buffers are marked as done and returned to the application via the callback defined in the waveInOpen function. 

 
Before attempting to close a waveform audio input device, call the waveInReset function to mark all pending buffers as done. Then, call the waveInClose 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_BADDEVICEID@T{ The specified device ID is out of range. T} MMSYSERR_HANDLEBUSY@T{ The handle hWaveIn is in use on another thread.  T}

See Also

 
 
 
 
 
waveInAddBuffer(3mms), waveInClose(3mms), waveInStart(3mms), waveInStop(3mms)