Click here to Skip to main content
13,296,823 members (47,092 online)
Click here to Skip to main content
Add your own
alternative version


18 bookmarked
Posted 16 May 2004


, 16 May 2004
Rate this:
Please Sign up or sign in to vote.
Create your own sound alerts to be accessed from the Control Panel, and played by your own program.

SoundApplet Image


Have you ever wondered how to add your own sound events to the Sounds section of the Control Panel? Of course, nothing is mentioned in the MSDN on how to do it - probably some undocumented API somewhere - so all the hard work discovering what to do had to be fathomed out empirically.

This article was inspired by another on CodeProject which outlines what needs to be done, but doesn't actually present any code.

The following addresses this problem and also provides a method of playing the sound events, which has proven problematic to some people.

Public Interface

The interface to this class is very simple, only providing 7 functions, but that's all you need :-)

As an example of the simplicity of this class, here is the test program I used whilst writing the class...

int main(int argc, char* argv[])
    CSoundAlert sa;

    sa.CreateGroup(_T("SoundApp"), _T("Sound Scheme Application"));

    sa.Create(_T("Start"), _T("Start Sound"), _T("%systemRoot%\\media\\ding.wav"));




    return 0;

This program creates a sound group, creates a single sound event, plays it, then deletes everything from the registry. Obviously, the deleting part should be done when uninstalling your application, but the creation should really be done when the program is run for the first time (for each user) as the registry settings are per user rather than system wide, and you don't want some people to miss out on the aural masterpiece your application will produce, do you.

Group Functions

bool CreateGroup(LPCTSTR szGroupName, LPCTSTR szTitle);
bool OpenGroup(LPCTSTR szGroupName);
bool DeleteGroup(LPCTSTR szGroupName);
bool DeleteGroup();

Alert Functions

bool Create(LPCTSTR szName, LPCTSTR szTitle, LPCTSTR szWavPath);
bool Delete(LPCTSTR szName);

Play sound function

bool Play(LPCTSTR szName, DWORD dwOptions=0);

Group Functions

A sound group is basically a place to store the sound alerts associated with your application. You can create as many groups as you like (but you also have to keep track of them !). To access a group, you need to either create it, or open it.

  • CreateGroup(LPCTSTR szGroupName, LPCTSTR szTitle)
    • szGroupName - the name to store your group under
    • szTitle - the text actually shown in the Control Panel. This allows the text to be internationalized without affecting the code.
  • OpenGroup(LPCTSTR szGroupName)
    • szGroupName - the name of the group to open.
  • DeleteGroup(LPCTSTR szGroupName)
    • szGroupName - the name of the group to delete. This doesn't need to be the current group.
  • DeleteGroup()

    Delete the current group.

Event functions

  • Create(LPCTSTR szName, LPCTSTR szTitle, LPCTSTR szWavPath)
    • szName - Name of the event
    • szTitle - Name of the event shown in the Control Panel
    • szWavPath - Path of the sound file to play. This can be a fully qualified path or just a filename (if the file is stored in the %systemRoot%\media directory, or specified using one of the environment variables (%windir%\my app)).
  • Delete(LPCTSTR szName)
    • szName - Name of the event to delete

Play Sound

  • Play(LPCTSTR szName, DWORD dwOptions=0)
    • szName - the name of the event to play
    • dwOptions - any of the standard PlaySound options


Hopefully, this article will allow you to add all important sound events to your otherwise quiet application - with a simple and effective class.

No MFC was harmed in the making of this class - and boy, was it hard not to :-)


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Software Developer (Senior)
United Kingdom United Kingdom
No Biography provided

You may also be interested in...

Comments and Discussions

GeneralYet ANOTHER Fix: DeleteGroup() doesn't work unless the group is already empty Pin
J Wofford28-Jan-05 9:20
memberJ Wofford28-Jan-05 9:20 
GeneralRe: Yet ANOTHER Fix: DeleteGroup() doesn't work unless the group is already empty Pin
Neil_Scales28-Jan-05 9:55
memberNeil_Scales28-Jan-05 9:55 
GeneralAnother Fix: Delete function doesn't delete anything Pin
J Wofford28-Jan-05 9:15
memberJ Wofford28-Jan-05 9:15 
GeneralAnother Fix: .exe name must match group name Pin
J Wofford28-Jan-05 9:01
memberJ Wofford28-Jan-05 9:01 
GeneralMinor fix in calls to RegSetValueEx() Pin
Ukkie91-Nov-04 1:33
memberUkkie91-Nov-04 1:33 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Permalink | Advertise | Privacy | Terms of Use | Mobile
Web02 | 2.8.171207.1 | Last Updated 17 May 2004
Article Copyright 2004 by Soundman32.2
Everything else Copyright © CodeProject, 1999-2017
Layout: fixed | fluid