DRVM_MAPPER_PREFERRED_SET
A version of this page is also available for
4/8/2010
This message is sent through the waveInMessage or waveOutMessage function to set the preferred device ID of the device referenced by WAVE_MAPPER to a new value.
Syntax
DRVM_MAPPER_PREFERRED_SET
wParam = OrigDeviceId
lParam = 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 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 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:
#define DRVM_MAPPER 0x2000
#define DRVM_MAPPER_PREFERRED_GET (DRVM_MAPPER+21)
#define DRVM_MAPPER_PREFERRED_SET (DRVM_MAPPER+22)
See Also
Reference
Waveform Audio Messages
waveInMessage
waveOutMessage