waveInStop function (mmeapi.h)
The waveInStop function stops waveform-audio input.
Syntax
MMRESULT waveInStop(
HWAVEIN hwi
);
Parameters
hwi
Handle to the waveform-audio input 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. |
Remarks
If there are any buffers in the queue, the current buffer will be marked as done (the dwBytesRecorded member in the header will contain the length of data), but any empty buffers in the queue will remain there.
Calling this function when input is not started has no effect, and the function returns zero.
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 |