waveInClose(3mms) — Subroutines
Name
waveInClose --- Close the specified waveform audio input device
Syntax
#include <mme/mme_api.h>
MMRESULT waveInClose (HWAVEIN hWaveIn)
Arguments
HWAVEIN hWaveIn
Specifies a handle to a waveform audio input device. If the function is successful, the handle is no longer valid after this call.
Description
The waveInClose function closes the specified waveform audio input device. If input buffers sent to the device with the waveInAddBuffer function have not been returned to the application, the close operation fails.
To ensure a successful close operation, 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_INVALHANDLE@T{ The specified device handle is invalid. T} WAVERR_STILLPLAYING@T{ There are buffers still in the queue. T}