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. |
Use the SoundsConfiguration Service Provider to configure the sounds associated with various events on the device.
Note: |
---|
This Configuration Service Provider is not available on Windows Mobile Professional and Windows Mobile Classic. |
Note: |
---|
This Configuration Service Provider can be managed over both the OMA Client Provisioning (formerly WAP Client Provisioning) and the OMA DM protocol. |
In the root characteristic, the default security roles are defined. The default security role maps to each subnode unless specific permission is granted to the subnode.
Permissions |
Read/write |
Roles allowed to query and update setting |
Manager AuthenticatedUser UnauthenticatedUser |
The following image shows the management object used by OMA DM.
The following image shows the Configuration Service Provider in tree format as used by OMA Client Provisioning.
Characteristics
- HKCU\ControlPanel\Sounds\BusyTone
-
Busy tone sound.
- HKCU\ControlPanel\Sounds\CallWaiting
-
Call waiting sound.
- HKCU\ControlPanel\Sounds\CellBroadcast
-
New Cell broadcast message.
- HKCU\ControlPanel\Sounds\Clock
-
Alarm 1 sound.
- HKCU\ControlPanel\Sounds\Clock2
-
Alarm 2 sound.
- HKCU\ControlPanel\Sounds\E-Mail
-
New e-mail sound.
- HKCU\ControlPanel\Sounds\IM
-
New IM message.
- HKCU\ControlPanel\Sounds\KeyPress
-
Key press sound.
- KCU\ControlPanel\Sounds\Loudest
-
The sound played on max volume change.
- KCU\ControlPanel\Sounds\LoudestInCall
-
The sound played on max volume change while in a call.
- HKCU\ControlPanel\Sounds\MenuCommand
-
Menu sound.
- HKCU\ControlPanel\Sounds\MenuPopup
-
Menu popup sound.
- HKCU\ControlPanel\Sounds\Password
-
Password sound.
- HKCU\ControlPanel\Sounds\Reminder
-
Reminder sound.
- HKCU\ControlPanel\Sounds\RingTone0
-
Ring Tone for Line 1.
- HKCU\ControlPanel\Sounds\RingTone1
-
Ring Tone for line 2.
- HKCU\ControlPanel\Sounds\SMS
-
New Short Message Service (SMS) message sound.
- KCU\ControlPanel\Sounds\Standard
-
The sound played on a normal (i.e. non-max) volume change.
- KCU\ControlPanel\Sounds\StandardInCall
-
The sound played on a normal (i.e. non-max) volume change while in a call.
- HKCU\ControlPanel\Sounds\SystemAsterisk
-
System asterisk sound.
- HKCU\ControlPanel\Sounds\SystemDefault
-
System default sound.
- HKCU\ControlPanel\Sounds\SystemExclamation
-
System exclamation sound.
- HKCU\ControlPanel\Sounds\SystemHand
-
System hand sound.
- HKCU\ControlPanel\Sounds\SystemStart
-
Boot up sound.
- HKCU\ControlPanel\Sounds\SystemQuestion
-
System Question sound.
- HKCU\ControlPanel\Sounds\Toolkit
-
SIM Toolkit event sound.
- HKCU\ControlPanel\Sounds\VoiceMail
-
New voice mail message sound.
- HKCU\ControlPanel\Sounds\Warning
-
System warning sound.
Parameters
- DeleteRingTone
-
This parm is used only under the root Soundscharacteristic. This parm is passed in containing the fully qualified path of the sound that is to be deleted. Only sound files that are stored in the %CE18%\Application Data\Soundsdirectory can be deleted using this parm, and only *.wav, *.mid, *.rmi files can be deleted by the Sound Configuration Service Provider. %CE18%represents the default volume. The translation="install" attribute informs the Configuration Manager to translate the CE string to the designated directory in Windows Mobile Standard.
The following table shows the default settings.
Permissions
Read/write
Data type
String
Roles allowed to query and update setting
Manager
AuthenticatedUser
- InitVol
-
Identifies the initial volume for System sound category.
The following table shows the default settings.
Permissions
Read/write
Data type
Integer
Roles allowed to query and update setting
Manager
AuthenticatedUser
- MessageBox
-
This parm is used in the HKCU\ControlPanel\Sounds\SystemExclamationcharacteristic to identify the sound associated for the system critical stop, exclamation and asterisk message types.
The following table shows the default settings.
Permissions
Read/write
Data type
Integer
Roles allowed to query and update setting
Manager
AuthenticatedUser
- ModeGSM
-
This parm is used in the HKCU\ControlPanel\Sounds\KeyPresscharacteristic to identify the beep mode for keypress sounds on a GSM phone.
The following table shows the default settings.
Permissions
Read/write
Data type
Integer
Label
Keypad control :
Roles allowed to query and update setting
Manager
AuthenticatedUser
- ModeCDMA
-
This parm is used in the HKCU\ControlPanel\Sounds\KeyPresscharacteristic to identify the beep mode for keypress sounds on a CDMA phone.
The following table shows the default settings.
Permissions
Read/write
Data type
Integer
Label
Keypad control :
Roles allowed to query and update setting
Manager
AuthenticatedUser
- RingTypeAll
-
This parm is used to identify the script that determines how a ring is played.
The following table shows the default settings.
Permissions
Read/write
Data type
String
Roles allowed to query and update setting
Manager
AuthenticatedUser
- Sound
-
This parm is used in all Soundscharacteristics. Under each characteristic, this parm is passed as a string specifying the fully qualified path of the sound file to play when the corresponding event occurs (for example, when the alarm clock time is up). Alternatively, you can specify the special values *vibrate*or *none*.
Value Description string
Sound file to play on event.
*vibrate*
Causes the phone to vibrate on event.
*none*
Causes the phone to do nothing on event.
The following table shows the default settings:
Permissions
Read/write
Data type
String
Roles allowed to query and update setting
Manager
AuthenticatedUser
UnauthenticatedUser
The following table shows how this parm is used in the Registry Configuration Service Provider:
- DeleteRingTone has the
Delete sound:label.
- HKCU\ControlPanel\Sounds\CallWaiting\Sound has the
Call waiting:label.
- HKCU\ControlPanel\Sounds\CellBroadcast\Sound has the
New channel message:label.
- HKCU\ControlPanel\Sounds\Clock\Sound has the
Alarm 1 sound:label.
- HKCU\ControlPanel\Sounds\Clock2\Sound has the
Alarm 2 sound:label.
- HKCU\ControlPanel\Sounds\E-Mail\Sound has the
New e-mail:label.
- HKCU\ControlPanel\Sounds\IM\Sound has the
Ring tone for line 1:label.
- HKCU\ControlPanel\Sounds\KeyPress\ModeGSM has the
Keypad control:label.
- HKCU\ControlPanel\Sounds\KeyPress\ModeCDMA has the
Keypad control:label.
- HKCU\ControlPanel\Sounds\MenuCommand\Sound has the
Menu command:label.
- HKCU\ControlPanel\Sounds\MenuPopup\Sound has the
Menu popup:label.
- HKCU\ControlPanel\Sounds\Password\Sound has the
Password:label.
- HKCU\ControlPanel\Sounds\Reminder\Sound has the
Reminders:label.
- HKCU\ControlPanel\Sounds\RingTone0\Sound has the
Ring tone for line 1:label.
- HKCU\ControlPanel\Sounds\RingTone1\Sound has the
Ring tone for line 2:label.
- HKCU\ControlPanel\Sounds\SMS\Sound has the
New SMS:label.
- HKCU\ControlPanel\Sounds\SystemAsterisk\Sound has the
Asterisk:label.
- HKCU\ControlPanel\Sounds\SystemDefault\Sound has the
System default:label.
- HKCU\ControlPanel\Sounds\SystemExclamation\MessageBox has the
Exclamation:label.
- HKCU\ControlPanel\Sounds\SystemHand\Sound has the
Critical stop:label.
- HKCU\ControlPanel\Sounds\SystemQuestion\Sound has the
Question:label.
- HKCU\ControlPanel\Sounds\SystemStart\Sound has the
Start up:label.
- HKCU\ControlPanel\Sounds\Toolkit\Sound has the
SIM toolkit messages:label.
- HKCU\ControlPanel\Sounds\VoiceMail\Sound has the
New voice message:label.
- HKCU\ControlPanel\Sounds\Warning\Sound has the
Warnings:label.
- HKCU\ControlPanel\Sounds\BusyTone\Sound has the
Busy:label.
- DeleteRingTone has the
Delete sound:label.
Microsoft Custom Elements
The following table shows the Microsoft custom elements that this Configuration Service Provider supports for OMA Client Provisioning.
Elements | Available |
---|---|
parm-query |
Yes |
noparm |
No |
nocharacteristic |
No |
characteristic-query |
No |
Use these elements to build standard OMA Client Provisioning (formerly WAP Client Provisioning) configuration XML. For information about specific elements, see MSPROV DTD Elements. For examples of how to generally use the Microsoft custom elements, see OMA Client Provisioning XML File Examples.
For information about OMA Client Provisioning, see OMA Client Provisioning Files.