SND_EVENT

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_VIBRATE and SND_SOUNDTYPE_NONE sound 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_VIBRATE and SND_SOUNDTYPE_NONE sound 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 sstType member of SNDFILEINFO structure are SND_SOUNDTYPE_ON, SND_SOUNDTYPE_VIBRATE, and SND_SOUNDTYPE_NONE. Invoking SndSetSound with SND_EVENT_ALL and a SNDFILEINFO structure 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

See Also

Reference

Sounds Enumerations