mixerGetID function (mmeapi.h)
The mixerGetID function retrieves the device identifier for a mixer device associated with a specified device handle.
Syntax
MMRESULT mixerGetID(
HMIXEROBJ hmxobj,
UINT *puMxId,
DWORD fdwId
);
Parameters
hmxobj
Handle to the audio mixer object to map to a mixer device identifier.
puMxId
Pointer to a variable that receives the mixer device identifier. If no mixer device is available for the hmxobj object, the value -1 is placed in this location and the MMSYSERR_NODRIVER error value is returned.
fdwId
Flags for mapping the mixer object hmxobj. The following values are defined.
| Value | Meaning |
|---|---|
| MIXER_OBJECTF_AUX | The hmxobj parameter is an auxiliary device identifier in the range of zero to one less than the number of devices returned by the auxGetNumDevs function. |
| MIXER_OBJECTF_HMIDIIN | The hmxobj parameter is the handle of a MIDI input device. This handle must have been returned by the midiInOpen function. |
| MIXER_OBJECTF_HMIDIOUT | The hmxobj parameter is the handle of a MIDI output device. This handle must have been returned by the midiOutOpen function. |
| MIXER_OBJECTF_HMIXER | The hmxobj parameter is a mixer device handle returned by the mixerOpen function. This flag is optional. |
| MIXER_OBJECTF_HWAVEIN | The hmxobj parameter is a waveform-audio input handle returned by the waveInOpen function. |
| MIXER_OBJECTF_HWAVEOUT | The hmxobj parameter is a waveform-audio output handle returned by the waveOutOpen function. |
| MIXER_OBJECTF_MIDIIN | The hmxobj parameter is the identifier of a MIDI input device. This identifier must be in the range of zero to one less than the number of devices returned by the midiInGetNumDevs function. |
| MIXER_OBJECTF_MIDIOUT | The hmxobj parameter is the identifier of a MIDI output device. This identifier must be in the range of zero to one less than the number of devices returned by the midiOutGetNumDevs function. |
| MIXER_OBJECTF_MIXER | The hmxobj parameter is the identifier of a mixer device in the range of zero to one less than the number of devices returned by the mixerGetNumDevs function. This flag is optional. |
| MIXER_OBJECTF_WAVEIN | The hmxobj parameter is the identifier of a waveform-audio input device in the range of zero to one less than the number of devices returned by the waveInGetNumDevs function. |
| MIXER_OBJECTF_WAVEOUT | The hmxobj parameter is the identifier of a waveform-audio output device in the range of zero to one less than the number of devices returned by the waveOutGetNumDevs function. |
Return value
Returns MMSYSERR_NOERROR if successful or an error otherwise. Possible error values include the following.
| Return code | Description |
|---|---|
|
The hmxobj parameter specifies an invalid device identifier. |
|
One or more flags are invalid. |
|
The hmxobj parameter specifies an invalid handle. |
|
One or more parameters are invalid. |
|
No audio mixer device is available for the object specified by hmxobj. The location referenced by puMxId also contains the value -1. |
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 |