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.
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 Values
Returns MMSYSERR_NOERROR if successful or an error otherwise. Possible error values include the following.
| Value | 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
** Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
** Windows 95/98/Me:** Included in Windows 95 and later.
** Header:** Declared in Mmsystem.h; include Windows.h.
** Library:** Use Winmm.lib.
See Also