waveOutGetID

The waveOutGetID function retrieves the device identifier for the given waveform-audio output device.

This function is supported for backward compatibility. New applications can cast a handle of the device rather than retrieving the device identifier.

Syntax

MMRESULT waveOutGetID(  HWAVEOUT hwo,  LPUINT puDeviceID);

Parameters

hwo

Handle to the waveform-audio output device.

puDeviceID

Pointer to a variable to be filled with the device identifier.

Return value

Returns MMSYSERR_NOERROR if successful or an error otherwise. Possible error values include the following.

Return code	Description
MMSYSERR_INVALHANDLE	The hwo parameter specifies an invalid handle.
MMSYSERR_NODRIVER	No device driver is present.
MMSYSERR_NOMEM	Unable to allocate or lock memory.

 

Requirements

Minimum supported client	Windows 2000 Professional
Minimum supported server	Windows 2000 Server
Header	Mmsystem.h (include Windows.h)
Library	Winmm.lib
DLL	Winmm.dll

See also

Waveform Audio Waveform Functions

 

 

Send comments about this topic to Microsoft

Build date: 9/7/2011