waveInPrepareHeader (Windows CE 5.0)
This function prepares a buffer for waveform input.
MMRESULT waveInPrepareHeader(HWAVEINhwi,LPWAVEHDRpwh,UINTcbwh );
Parameters
- hwi
Handle to the waveform-audio input device. - pwh
Pointer to a WAVEHDR structure that identifies the buffer to be prepared. The buffer's base address must be aligned with the respect to the sample size. - cbwh
Size, in bytes, of the WAVEHDR structure.
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_INVALPARAM | The buffer's base address is not aligned with the sample size. |
| MMSYSERR_NODRIVER | No device driver is present. |
| MMSYSERR_NOMEM | Unable to allocate or lock memory. |
Remarks
The lpData, dwBufferLength, and dwFlags members of the WAVEHDR structure must be set before calling this function (dwFlags must be zero).
Requirements
OS Versions: Windows CE 2.0 and later.
Header: Mmsystem.h.
Link Library: Coredll.lib.
See Also
Waveform Audio Functions | WAVEHDR
Send Feedback on this topic to the authors