Share via

SND_EVENT

  • Article

Send Feedback

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

typedef enum tagSND_EVENT {
   SND_EVENT_ALL,
   SND_EVENT_RINGTONELINE1,
   SND_EVENT_RINGTONELINE2,
   SND_EVENT_LAST = SND_EVENT_RINGTONELINE2
} 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_LAST
    The ringtone for line 2 of the phone

Remarks

SND_EVENT_ALL is currently supported only on a Windows Mobile-based Pocket PC and 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 Pocket PC Volume Bubble on the home screen. 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

Pocket PC: Windows Mobile Version 5.0 and later
Smartphone: Windows Mobile Version 5.0 and later
OS Versions: Windows CE 5.0 and later
Header: Soundfile.h

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.