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);

你可能感兴趣的:(WinCE,wince,dll,application,winapi,parameters,null)