Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 |
|---|---|
|
The hwo parameter specifies an invalid handle. |
|
No device driver is present. |
|
Unable to allocate or lock memory. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | mmeapi.h (include Windows.h) |
| Library | Winmm.lib |
| DLL | Winmm.dll |