waveOutGetID function
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 [desktop apps only] |
Minimum supported server |
Windows 2000 Server [desktop apps only] |
Header |
Mmsystem.h (include Windows.h) |
Library |
Winmm.lib |
DLL |
Winmm.dll |