Share via


waveOutClose

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function closes the specified waveform output device.

Syntax

MMRESULT waveOutClose(
  HWAVEOUT hwo 
); 

Parameters

  • hwo
    Handle to the waveform-audio output device. If the function succeeds, the handle is no longer valid after this call.

Return Value

One of the values described in the following table is returned.

Value Description

MMSYSERR_NOERROR

Success.

MMSYSERR_INVALHANDLE

Specified device handle is invalid.

MMSYSERR_NODRIVER

No device driver is present.

MMSYSERR_NOMEM

Unable to allocate or lock memory.

WAVERR_STILLPLAYING

There are still buffers in the queue.

Remarks

If the device is still playing a waveform-audio file, the close operation fails. Use the waveOutReset function to terminate playback before calling waveOutClose.

Requirements

Header mmsystem.h
Library coredll.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

Waveform Audio Functions