waveInPrepareHeader

Syntax

WORD waveInPrepareHeader(hWaveIn, lpWaveInHdr, wSize)

This function prepares a buffer for waveform input.

Parameters

HWAVEIN hWaveIn

Specifies a handle to the waveform input device.

LPWAVEHDR lpWaveInHdr

Specifies a pointer to a WAVEHDR structure that identifies the buffer to be prepared.

WORD wSize

Specifies the size of the WAVEHDR structure.

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.

MMSYSERR_NOMEM

Unable to allocate or lock memory.

Comments

The WAVEHDR data structure and the data block pointed to by its lpData field must be allocated with GlobalAlloc using the GMEM_MOVEABLE and GMEM_SHARE flags, and locked with GlobalLock. Preparing a header that has already been prepared will have no effect, and the function will return zero.

See Also

waveInUnprepareHeader