Share via

DRVM_MAPPER_PREFERRED_SET

  • Article

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.

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.

Requirements

OS Versions: Windows Mobile 5.0 AKU1 and later.

See Also

Waveform Audio Messages | Switching Preferred Audio Devices | waveInMessage | waveOutMessage