Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This message is sent through the waveInMessageor waveOutMessagefunction 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:

Copy Code 
#define DRVM_MAPPER 0x2000
#define DRVM_MAPPER_PREFERRED_GET (DRVM_MAPPER+21) 
#define DRVM_MAPPER_PREFERRED_SET (DRVM_MAPPER+22)

See Also