waveInStart

  MMRESULT waveInStart(hWaveIn)    
  HWAVEIN hWaveIn;    

The waveInStart function starts input on the specified waveform input device.

Parameters

hWaveIn

Specifies a handle to the waveform input device.

Return Value

Returns zero if the function was successful. Otherwise, it returns an error number. Possible error returns are:

Value Meaning

MMSYSERR_INVALHANDLE Specified device handle is invalid.
MMSYSERR_HANDLEBUSY The handle hWaveIn is in use on another thread.

Comments

Buffers are returned to the client when full or when waveInReset is called (the dwBytesRecorded field in the header will contain the actual length of data). If there are no buffers in the queue, the data is thrown away without notification to the client, and input continues.

Calling this function when input is already started has no effect, and the function returns zero.

See Also

waveInStop, waveInReset