waveInClose

Syntax

WORD waveInClose(hWaveIn)

This function closes the specified waveform input device.

Parameters

HWAVEIN hWaveIn

Specifies a handle to the waveform input device. If the function is successful, the handle is no longer valid after this call.

Return Value

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

MMSYSERR_INVALHANDLE

Specified device handle is invalid.

WAVERR_STILLPLAYING

There are still buffers in the queue.

Comments

If there are input buffers that have been sent with waveInAddBuffer, and haven't been returned to the application, the close operation will fail. Call waveInReset to mark all pending buffers as done.

See Also

waveInOpen, waveInReset