DRVM_MAPPER_PREFERRED_SET (Windows Embedded NavReady)
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
10/16/2008
Applies to Windows Embedded NavReadyUpdate KB956296
This message sets the device ID of the preferred audio device, which is referenced by the WAVE_MAPPER constant. The message is sent through the waveInMessage or waveOutMessage function.
wParam = OrigDeviceIdlParam = NewDeviceId
Parameters
- OrigDeviceId
The current device ID of the device to be moved. Legal values range from 0 to N-1, where N is the number of wave devices on the system.
- NewDeviceId
The device ID to which the device should be moved. Legal values range from 0 to N-1, where N is the number of devices on the system. If the value is set to 0, the device is set as the preferred device. If the value is set to -1, the device is moved to the highest-numbered device ID.
Return Values
One of the values described in the following table is returned.
| Value | Description |
|---|---|
MMSYSERR_NOERROR |
The call was a success. |
MMSYSERR_ERROR |
The call failed. |
MMSYSERR_NOTSUPPORTED |
This implementation of the waveapi code does not support setting the preferred device ID. |
Remarks
DRVM_MAPPER_PREFERRED_SET and DRVM_MAPPER_PREFERRED_GET are not defined by Windows Embedded CE. To use these messages, you must first define them in your code, as follows:
#define DRVM_MAPPER 0x2000
#define DRVM_MAPPER_PREFERRED_GET (DRVM_MAPPER+21)
#define DRVM_MAPPER_PREFERRED_SET (DRVM_MAPPER+22)
Requirements
| Windows Embedded CE | Windows CE 5.0, Windows Embedded NavReady 2009 |