WinCE系统音量的设置

//========================================================================
//TITLE:
//    WinCE系统音量的设置
//AUTHOR:
//    norains
//DATE:
//    Sunday  8-April-2007
//Environment:
//        EVC4.0 + Standard SDK 4.2
//        EVC4.0 + Standard SDK 5.0
//========================================================================

        首先我们来看一段最简单的改变音量的代码:
 

       DWORD dwVolume  =   0xAAAAAAAA ;
        waveOutSetVolume( 0 ,dwVolume);

       
        waveOutSetVolume()的第一个参数是设备ID,因为需要更改的是整个系统音量,所以在这里直接取0值即可;第二个参数是需要设置的音量数值,范围是从 0x0 ~ 0xFFFFFFFF.
       
        但这个函数的功能却也是非常有限的,也就是说,它只能更改系统的主音量;如果想修改屏幕点击声,则就无能为力.
       
        有些细心的朋友会从"控制面板"的"声音"入手,发现每次在控制面板调节声音,相应的"ControlPanel/Volume"下的键值数值都会变更.但如果是直接修其下的改注册表,却是无论如何都达不到相应的功能的----因为没有通知系统,注册表已经被修改.
       
        如果需要告知系统,注册表已经修改,并请系统依照修改的数值来更改音量,则需要调用微软一个未公开的函数:AudioUpdateFromRegistry().
       
        这个函数在文档中是无法搜索到,如果需要调用这个函数,可以有两种方法.
       
        一是直接包含"pwinuser.h"文件,然后直接调用.
       
        二是调用coredll.dll库,引出该函数并使用.
       
        这里展示一个调用的例子:

        typedef  void  (WINAPI  * DLL_AUDIOUPDATEFROMREGISTRY)();

        DLL_AUDIOUPDATEFROMREGISTRY Dll_AudioUpdateFromRegistry  =  NULL; 
        HINSTANCE hCoreDll  =  LoadLibrary(TEXT( " coredll.dll " )); 
         if  (hCoreDll) 
         ... { 
            Dll_AudioUpdateFromRegistry = (DLL_AUDIOUPDATEFROMREGISTRY)GetProcAddress(hCoreDll, _T("AudioUpdateFromRegistry")); 
            if (Dll_AudioUpdateFromRegistry) 
            ...{ 
                (Dll_AudioUpdateFromRegistry)(); 
            } 

        只要更新了注册表,然后调用该函数,则系统会根据键值来进行相应的调整.
       
        那么现在让我们来看看位于"ControlPanel/Volume"注册表中各键值的意义:
       
        Volume: 系统的主音量,范围是0x0 ~ 0xFFFFFFFF.
       
        Screen: 屏幕敲击声. 当数值为0时即为无声,1为柔和,65538为洪亮

        Key: 键盘敲击声,数值的意义和Screen相同.
       
        Mute: 控制其它静音的选项. 置0x04位为1时允许事件声音,0x02允许应用程序声音,0x01允许警告声.需要注意的是,如果不允许应用程序声音,则警告声位也将被忽略.
       
       
        如果每次更改音量都要改写注册表,调用动态链接库,会显得比较麻烦.为了写代码的便利,在此封装了这个声音的操作:
(注:CReg 请参见此篇文章:http://blog.csdn.net/norains/archive/2007/04/08/1556296.aspx)

        
/**/ //////////////////////////////////////////////////////////////////////
//  SysVolume.h: interface for the CSysVolume class.
//
// Version:
//     1.0.0
// Date:
//     2007.04.08
/**/ //////////////////////////////////////////////////////////////////////

#ifndef SYSVOLUME_H
#define  SYSVOLUME_H



#include  " Reg.h "

// -------------------------------------------------------------------------
// Macro define
#define  MIN_VOLUME            0
#define  MAX_VOLUME            0xFFFFFFFF
// -------------------------------------------------------------------------
// Enum value
enum  VolumeModeType
... {
    VOL_SOFT,
    VOL_LOUD,
    VOL_MUTE
} ;
// ------------------------------------------------------------------------

class  CSysVolume  
... {
public:
    BOOL SetVolumeScreenTap(VolumeModeType volMode);
    BOOL SetVolumeKeyClick(VolumeModeType volMode);
    BOOL EnableSoundNotification(BOOL bEnable);
    BOOL EnableSoundApplication(BOOL bEnable);
    BOOL EnableSoundEvent(BOOL bEnable);
    BOOL SetVolume(DWORD dwVol);
    CSysVolume();
    virtual ~CSysVolume();

protected:
    BOOL Apply();
    CReg m_Reg;
} ;

#endif   // #ifndef SYSVOLUME_H
        

/**/ //////////////////////////////////////////////////////////////////////        
//  SysVolume.cpp: implementation of the CSysVolume class.
//
/**/ //////////////////////////////////////////////////////////////////////

#include  " stdafx.h "
#include  " SysVolume.h "


// ======================================================================
// Macro define

// Registry KEY
#define  BASE_KEY                     HKEY_CURRENT_USER
#define  SUB_KEY                        TEXT("ControlPanel/Volume")
#define  VALUE_VOLUME                TEXT("Volume")
#define  VALUE_SCREEN                TEXT("Screen")
#define  VALUE_KEY                    TEXT("key")
#define  VALUE_MUTE                    TEXT("Mute")


// For the screen tap and the key click
#define  VOL_VALUE_MUTE                0
#define  VOL_VALUE_LOUD                65538
#define  VOL_VALUE_SOFT                1


// The bit for sound
#define  BIT_EVENT                    0x4
#define  BIT_APPLICATION                0x2
#define  BIT_NOTIFICATION            0x1
// ======================================================================
/**/ //////////////////////////////////////////////////////////////////////
//  Construction/Destruction
/**/ //////////////////////////////////////////////////////////////////////

CSysVolume::CSysVolume()
... {
    m_Reg.Create(BASE_KEY, SUB_KEY);
}

CSysVolume:: ~ CSysVolume()
... {

}





// ---------------------------------------------------------------------
// Description:
//     Apply the volume
// ---------------------------------------------------------------------
BOOL CSysVolume::Apply()
... {
    typedef void (WINAPI *DLL_AUDIOUPDATEFROMREGISTRY)();

    DLL_AUDIOUPDATEFROMREGISTRY Dll_AudioUpdateFromRegistry = NULL; 
    HINSTANCE hCoreDll = LoadLibrary(TEXT("coredll.dll")); 
    if (hCoreDll) 
    ...{ 
        Dll_AudioUpdateFromRegistry = (DLL_AUDIOUPDATEFROMREGISTRY)GetProcAddress(hCoreDll, _T("AudioUpdateFromRegistry")); 
        if (Dll_AudioUpdateFromRegistry) 
        ...{ 
            (Dll_AudioUpdateFromRegistry)(); 
        } 
        else
        ...{
            return FALSE;
        }
        FreeLibrary(hCoreDll); 
    } 
    else
    ...{
        return FALSE;
    }
    return TRUE;
}



// ---------------------------------------------------------------------
// Description:
//     Enable the sound for events
// ---------------------------------------------------------------------
BOOL CSysVolume::EnableSoundEvent(BOOL bEnable)
... {
    if(m_Reg.IsOK() != TRUE)
    ...{
        return FALSE;
    }
    
    DWORD dwVal = m_Reg.GetValueDW(VALUE_MUTE);

    if(bEnable == TRUE)
    ...{
        dwVal |= BIT_EVENT;
    }
    else
    ...{
        dwVal &= ~BIT_EVENT;
    }

    m_Reg.SetDW(VALUE_MUTE,dwVal);

    return Apply();
}


// ---------------------------------------------------------------------
// Description:
//     Enable the sound for application
// ---------------------------------------------------------------------
BOOL CSysVolume::EnableSoundApplication(BOOL bEnable)
... {
    if(m_Reg.IsOK() != TRUE)
    ...{
        return FALSE;
    }

    DWORD dwVal = m_Reg.GetValueDW(VALUE_MUTE);

    if(bEnable == TRUE)
    ...{
        dwVal |= BIT_APPLICATION;
    }
    else
    ...{
        dwVal &= ~BIT_APPLICATION;
    }

    m_Reg.SetDW(VALUE_MUTE,dwVal);

    return Apply();
}


// ---------------------------------------------------------------------
// Description:
//     Enable the sound for notifications. If the sound of application is
// mute, the sound of  notification is mute too.
// ---------------------------------------------------------------------
BOOL CSysVolume::EnableSoundNotification(BOOL bEnable)
... {
    if(m_Reg.IsOK() != TRUE)
    ...{
        return FALSE;
    }

    DWORD dwVal = m_Reg.GetValueDW(VALUE_MUTE);

    if(bEnable == TRUE)
    ...{
        dwVal |= BIT_NOTIFICATION;
    }
    else
    ...{
        dwVal &= ~BIT_NOTIFICATION;
    }

    m_Reg.SetDW(VALUE_MUTE,dwVal);

    return Apply();
}


// ---------------------------------------------------------------------
// Description:
//     Set the key click volume
// ---------------------------------------------------------------------
BOOL CSysVolume::SetVolumeKeyClick(VolumeModeType volMode)
... {

    DWORD dwVol = 0;

    switch(volMode)
    ...{
        case VOL_SOFT:
            dwVol = VOL_VALUE_SOFT;
            break;
        case VOL_LOUD:
            dwVol = VOL_VALUE_LOUD;
            break;
        case VOL_MUTE:
            dwVol = VOL_VALUE_MUTE;
            break;
    }
    
    if(m_Reg.IsOK() != TRUE)
    ...{
        return FALSE;
    }
    m_Reg.SetDW(VALUE_KEY,dwVol);
    
    return Apply();
}


// ---------------------------------------------------------------------
// Description:
//     Set the screen tap volume
// ---------------------------------------------------------------------
BOOL CSysVolume::SetVolumeScreenTap(VolumeModeType volMode)
... {    
    DWORD dwVol = 0;

    switch(volMode)
    ...{
        case VOL_SOFT:
            dwVol = VOL_VALUE_SOFT;
            break;
        case VOL_LOUD:
            dwVol = VOL_VALUE_LOUD;
            break;
        case VOL_MUTE:
            dwVol = VOL_VALUE_MUTE;
            break;
    }

    if(m_Reg.IsOK() != TRUE)
    ...{
        return FALSE;
    }
    m_Reg.SetDW(VALUE_SCREEN,dwVol);
    return Apply();
}


// ---------------------------------------------------------------------
// Description:
//     Set the volume. 
//
// Parameters:
//     dwVol: The volume to set. And the range is MIN_VOLUME ~  MAX_VOLUME
// ---------------------------------------------------------------------
BOOL CSysVolume::SetVolume(DWORD dwVol)
... {
    if(dwVol < MIN_VOLUME || dwVol > MAX_VOLUME)
    ...{
        return FALSE;
    }
    m_Reg.SetDW(VALUE_VOLUME,dwVol);
    return Apply();
}

        由于CSysVolume类将复杂的操作封装在内部,因此设置音量的非常简单.
       
        以更改屏幕敲击声为洪亮为例:

        CSysVolume sysVol;
        sysVol.SetVolumeScreenTap(VOL_LOUD);