|
waveOutUnprepareHeader
The waveOutUnprepareHeader function cleans up the preparation performed by the waveOutPrepareHeader function. This function must be called after the device driver is finished
with a data block. You must call this function before freeing the buffer.
MMRESULT waveOutUnprepareHeader(
HWAVEOUT hwo,
|
| LPWAVEHDR pwh,
|
| UINT cbwh
|
| );
|
|
Parameters
hwo
Handle of the waveform-audio output device.
pwh
Address of a WAVEHDR structure identifying the data block 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 data block pointed to by the pwh parameter is still in the queue.
|
Remarks
This function complements waveOutPrepareHeader. You must call this function before freeing the buffer. After passing a
buffer to the device driver with the waveOutWrite function, you must wait until the driver is finished with the buffer before
calling waveOutUnprepareHeader.
Unpreparing a buffer that has not been prepared has no effect, and the
function returns zero.
See Also
waveOutPrepareHeader, WAVEHDR, waveOutWrite
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
TMS Scripter Studio Pro components for Delphi/C++Builder
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
|
