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.
4/8/2010

This enumeration indicates the sound event type to set or query.

Syntax 

typedef enum tagSND_EVENT {
   SND_EVENT_ALL,
   SND_EVENT_RINGTONELINE1,
   SND_EVENT_RINGTONELINE2,
   SND_EVENT_KNOWNCALLERRINGTONELINE1,
   SND_EVENT_ROAMINGRINGTONELINE1,
   SND_EVENT_RINGTONELINEVOIP,
   SND_EVENT_LAST = SND_EVENT_RINGTONELINEVOIP
} SND_EVENT;

Enumerations

SND_EVENT_ALL

This is a special sound event that applies to all sounds on a system wide scale. See Remarks for more information.

SND_EVENT_RINGTONELINE1

The ringtone for line 1 of the phone

SND_EVENT_RINGTONELINE2

The ringtone for line 2 of the phone

SND_EVENT_KNOWNCALLERRINGTONELINE1

The ringtone to play for a caller in the contact list who has no contact-specific ring tone. This event does not support the SND_SOUNDTYPE_VIBRATEand SND_SOUNDTYPE_NONEsound types. Currently applies to both lines without distinction.

SND_EVENT_ROAMINGRINGTONELINE1

The ringtone to play while roaming. This has higher priority than other ring tones. This event does not support the SND_SOUNDTYPE_VIBRATEand SND_SOUNDTYPE_NONEsound types. Currently applies to both lines without distinction.

Note:
Roaming ringtone only supports RingTone0 and no other ring types.
SND_EVENT_RINGTONELINEVOIP

The ringtone for VoIP line of the phone.

SND_EVENT_LAST

The ringtone for VoIP line of the phone

Remarks

SND_EVENT_ALL is currently supported only on Windows Mobile Professional and Windows Mobile Classic; the only valid values for sstTypemember of SNDFILEINFOstructure are SND_SOUNDTYPE_ON, SND_SOUNDTYPE_VIBRATE, and SND_SOUNDTYPE_NONE. Invoking SndSetSoundwith SND_EVENT_ALL and a SNDFILEINFOstructure set to one of the above values will be equivalent to the user using the Volume Bubble on the Home screen of Windows Mobile Professional and Windows Mobile Classic. If the volume bubble is currently open the change will be reflected in the bubble right away. If the bubble is not open the change will take effect immediately and will be visible the next time the user opens the bubble.

Requirements

Header soundfile.h
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also