This function starts input on the specified waveform input device.
At a Glance
| Header file: | Mmsystem.h |
| Windows CE versions: | 2.0 and later |
Syntax
MMRESULT waveInStart(HWAVEIN hwi);
Parameters
hwi
Handle to the waveform-audio input device.
Return Values
One of the values described in the following table is returned.
| Value | Description |
| MMSYSERR_NOERROR | Success. |
| MMSYSERR_INVALHANDLE | Specified device handle is invalid. |
| MMSYSERR_NODRIVER | No device driver is present. |
| MMSYSERR_NOMEM | Unable to allocate or lock memory. |
Remarks
Buffers are returned to the application when full or when the waveInReset function is called (the dwBytesRecorded member in the header will contain the length of data). If there are no buffers in the queue, the data is thrown away without notifying the application, and input continues.
Calling this function when input is already started has no effect, and the function returns zero.