waveInStart(3mms) — Subroutines
Name
waveInStart --- Start audio recording
Syntax
#include <mme/mme_api.h>
MMRESULT waveInStart(HWAVEIN hWaveIn)
Arguments
HWAVEIN hWaveIn
Specifies a handle to a waveform audio input device.
Description
The waveInStart function starts recording on the specified waveform audio input device. Buffers are returned to the client when they are full or when the waveInReset function is called. (The dwBytesRecorded field in the header contains the actual length of data.) If no buffers are in the queue, the data is thrown away, the client is not notified, and input continues.
Calling the waveInStart function when input is already started has no effect, and the function returns the MMSYSERR_NOERROR error code.
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 hWaveIn is in use on another thread. T}