|
waveInUnprepareHeader
The waveInUnprepareHeader function cleans up the preparation performed by the waveInPrepareHeader function. This function must be called after the device driver fills a buffer
and returns it to the application. You must call this function before freeing
the buffer.
MMRESULT waveInUnprepareHeader(
HWAVEIN hwi,
|
| LPWAVEHDR pwh,
|
| UINT cbwh
|
| );
|
|
Parameters
hwi
Handle of the waveform-audio input device.
pwh
Address of a WAVEHDR structure identifying the buffer to be cleaned up.
cbwh
Size, in bytes, of the WAVEHDR structure.
Return Values
Returns MMSYSERR_NOERROR if successful or an error otherwise. Possible error
values include the following:
MMSYSERR_INVALHANDLE
| Specified device handle is invalid.
| MMSYSERR_NODRIVER
| No device driver is present.
| MMSYSERR_NOMEM
| Unable to allocate or lock memory.
| WAVERR_STILLPLAYING
| The buffer pointed to by the pwh parameter is still in the queue.
|
Remarks
This function complements the waveInPrepareHeader function.
You must call this function before freeing the buffer. After passing a buffer
to the device driver with the waveInAddBuffer function, you must wait until the driver is finished with the buffer before
calling waveInUnprepareHeader. Unpreparing a buffer that has not been prepared has no effect, and the
function returns zero.
See Also
waveInPrepareHeader, WAVEHDR, waveInAddBuffer
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
More Online Helps
Win32 Programmer's Reference (win32.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
