VC知识库文章 - 利用键盘钩子开发按键发音程序

一、前言
一日，看见我妈正在用电脑练习打字，频频低头看键盘，我想：要是键盘能发音的话，不就可以方便她养成"盲打"的好习惯吗？光想不做可不行，开始行动(您可千万别急着去拿工具箱啊^_^)...
按键能发音，其关键就是让程序能够知道当前键盘上是哪个键被按下，并播放相应的声音,自己的程序当然不在话下，那么其它程序当前按下哪个键如何得知呢？利用键盘钩子便可以很好地解决。

大小:552K

二、挂钩(HOOK)的基本原理
WINDOWS调用挂接的回调函数时首先会调用位于函数链首的函数，我们只要将自己的回调函数置于链首，该回调函数就会首先被调用。那么如何将我们自己的回调函数置于函数链的链首呢？函数SetWindowsHookEx()实现的就是该功能。我们首先来看一下SetWindowsHookEx函数的原型:

HHOOK SetWindowsHookEx(
  int idHook,       
  HOOKPROC lpfn,     
  HINSTANCE hMod,    
  DWORD dwThreadId  
); 

第一个参数:指定钩子的类型，有WH_MOUSE、WH_KEYBOARD等十多种(具体参见MSDN)
第二个参数:标识钩子函数的入口地址
第三个参数:钩子函数所在模块的句柄；
第四个参数:钩子相关函数的ID用以指定想让钩子去钩哪个线程，为0时则拦截整个系统的消息。

另外需要注意的是为了捕获所有事件，挂钩函数应该放在动态链接库DLL中。

三、具体实现
理论的话就不多说了，运行VC++6.0，新建一个MFC AppWizard(dll)工程，命名为Hook，使用默认的创建DLL类型的选项，也就是使用共享MFC DLL，点击完成后开始编写代码:

(1)在Hook.h中定义全局函数

BOOL installhook(); //钩子安装函数
LRESULT CALLBACK KeyboardProc(int nCode, WPARAM wParam, LPARAM lParam);//挂钩函数

(2)在Hook.cpp文件的#endif下添加定义全局变量Hook的代码:

static HHOOK hkb=NULL;
HINSTANCE hins; //钩子函数所在模块的句柄

(3)添加核心代码

BOOL installhook()
{
    hkb=SetWindowsHookEx(WH_KEYBOARD,(HOOKPROC)KeyboardProc,hins,0);
    return TRUE;
}

第一个参数指定钩子的类型，因为我们只用到键盘操作所以设定为WH_KEYBOARD；第二个参数将钩子函数的入口地址指定为KeyboardProc，当钩子钩到任何消息后便调用这个函数,即当不管系统的哪个窗口有键盘输入马上会引起KeyboardProc的动作；第三个参数是钩子函数所在模块的句柄；最后一个参数是钩子相关函数的ID用以指定想让钩子去钩哪个线程，为0时则拦截整个系统的消息；
现在，就开始定义当键盘上的键按下时程序要做什么了~
KeyboardProc动作:

LRESULT CALLBACK KeyboardProc(int nCode,WPARAM wParam,LPARAM lParam)
{ 
    if(((DWORD)lParam&0x40000000) && (HC_ACTION==nCode))
    {
       switch(wParam) //键盘按键标识
        {
        case ''1'':sndPlaySound("1.wav",SND_ASYNC);break; //当数字键1被按下
         case ''2'':sndPlaySound("2.wav",SND_ASYNC);break;
        case ''3'':sndPlaySound("3.wav",SND_ASYNC);break;
        case ''4'':sndPlaySound("4.wav",SND_ASYNC);break;
        ....
        case ''A'':sndPlaySound("a.wav",SND_ASYNC);break; //当字母键A被按下
         case ''B'':sndPlaySound("b.wav",SND_ASYNC);break;
        case ''C'':sndPlaySound("c.wav",SND_ASYNC);break;
        case ''D'':sndPlaySound("d.wav",SND_ASYNC);break;
        ....
        }
     }
     LRESULT RetVal = CallNextHookEx( hkb, nCode, wParam, lParam ); 
     return RetVal;
}

上面的代码中我们用播放声音做为按键被按下后的动作，API函数sndPlaySound的第一个参数定义的声音文件的绝对路径(比如要播放C盘下的a.wav，就定义成"C:\\a.wav")；第二参数定义播放模式，SND_ASYNC模式可以及时地释放正在播放的声音文件，立刻停止当前声音的播放转去播放新的声音,这样在我们连续击键时就不会有阻塞感了.为了执行sndPlaySound函数，必须在Hook.cpp的文件头加上：

 #include "mmsystem.h"

并且点击VC++菜单上的“工程”-“设置”进入Link属性页，在L对象/库模块下输入：winmm.lib后确定即可.

(4)添加输出标识
在Hook.def的末尾添加

installhook
KeyboardProc

短短的四步，键盘钩子的制作算是完成了，编译生成后的DLL文件就可以自由的用别的程序来调用了.
在程序中如何调用DLL呢？那就简单了.再用VC++6.0新建一个MFC AppWizard(exe)工程，命名为KeySound，点击"确定"后选择程序类型为对话框，直接点击确定即可.
在KeySoundDlg.cpp文件中的OnInitDialog()初始化函数的CDialog::OnInitDialog();下面添加:

//阻止程序反复驻留内存，也为了防止有两个程序同时读取DLL而发生错误.

CreateMutex(NULL, FALSE, "KeySound");
if(GetLastError()==ERROR_ALREADY_EXISTS)
   OnOK();

//读取DLL
static HINSTANCE hinstDLL; 
typedef BOOL (CALLBACK *inshook)(); 
inshook instkbhook;
if(hinstDLL=LoadLibrary((LPCTSTR)"Hook.dll"))
{
    instkbhook=(inshook)GetProcAddress(hinstDLL,"installhook");  
    instkbhook();
}
else
{
    MessageBox("当前目录找不到Hook.dll文件，程序初始化失败");
    OnOK();
}

将编译生成后的KeySound.exe和Hook.dll放在同一目录下，定义好声音文件，运行KeySound.exe后打开记事本或写字板，体验一下系统为您即时快速地朗读您按下的每一个键的快感吧^-^

有一点必须说明，标准键盘有101个键，您想让多少键发声音，就必须在上面的KeyboardProc动作里定义多少个键，常用的10个数字键和26个英文字母不会给您带来太大的困难，只要相应的''A''对应A键,''1''对应1键就可以，但如果您希望能让更多的键都有各种特色音乐的话，很可能会遇到一些键盘编码上的麻烦，比如ESC键就不能简单的用''ESC''来搞定了，得用VK_ESCAPE，又比如Alt键得用VK_MENU来定义，没有个键盘编码表的话会令人相当头疼，这里我介绍一种让程序来告诉您键盘按键名称的方法:
为一个工程添加PreTranslateMessage映射，添加如下代码:

char KeyName[50];
ZeroMemory(KeyName,50);
if(pMsg -> message == WM_KEYDOWN)
{ 
   GetKeyNameText(pMsg->lParam,KeyName,50);
   MessageBox(KeyName);
} 

那么当程序窗口显示在面前时按下某个键，就会弹出一个消息显示该键的名称，然后用''''包起来就可以了，比如逗号句号，就是'',''和''.''，简单吧:)

到此就全部完成了按键发音程序的编写，通过改变声音文件的名称而不用改动程序本身就可以达到更换按键声音的目的了，只是有个遗憾，声音文件在硬盘中的位置不能变更，从C盘换移动D盘程序就不能播放了，怎么样才能灵活的读取声音文件呢？可以用API函数GetModuleFileName来得到程序所在的目录，具体实现方法如下：
(1)在Hook.h的public:下面添加:

BOOL InitInstance(); //初始化函数

(2)在Hook.cpp的#endif下添加定义全局变量的代码:

char szBuf[256];
char *p;
CString msg;

(3)在Hook.cpp中适当位置添加:

BOOL CHookApp::InitInstance ()
{ 
   hins=AfxGetInstanceHandle();
   GetModuleFileName(AfxGetInstanceHandle( ),szBuf,sizeof(szBuf));
   p = szBuf;
   while(strchr(p,''\\'')) 
   { 
        p = strchr(p,''\\''); 
        p++; 
   }
   *p = ''\0''; 
   msg=szBuf;
   return TRUE; 
}

(4)新建一个文件夹并命名为Sound;

(5)改变声音文件物理位置定义方式

case ''1'':sndPlaySound(msg+"sound\\1.wav",SND_ASYNC);break; 

msg是得到程序当前所在目录，加上后面的代码就是指播放当前目录下的Sound目录里的1.wav文件，这样就将声音文件的绝对路径改成了灵活的相对路径.您只要把KeySound.exe,Hook.dll和Sound文件夹放在同一个文件夹下，以后只要搬动整个文件夹就能实现声音文件的任意移动了。

调试时需要注意：将Hook.dll、Sound目录放在KeySound.exe的执行目录下。假如编译链接的时候出现unresolved external symbol __imp__sndPlaySoundA@8 这样的信息，请在Project Settings中加入Winmm.lib 。

--------------------next---------------------

文件写得不错,还附有代码
感谢...
//不过也试试运行narrator ( shyvens 发表于 2008-2-25 0:37:00)
 
写得很清楚，条理清晰呀。好～～ ( ahxh2000 发表于 2006-9-16 12:03:00)
 
lParam&0x40000000 是什么意思呢？
应该是判别是按键松开还是按下的 ( 电风扇恶魔 发表于 2005-9-9 20:46:00)
 
lParam&0x40000000 是什么意思呢？
谁能告诉我怎么把这个程序移植到COM组件内，实现键盘钩子 ( SunnyWay 发表于 2005-8-10 11:58:00)
 
不错，很不错，非常不错 ( finicswang 发表于 2005-4-7 14:29:00)
 
F键和S键好像是一样的.
不过文章写得非常的好.
很不错. ( shenghuafen 发表于 2004-7-14 13:38:00)
 
真是篇好文章呀。 ( xxzeng 发表于 2004-3-23 13:30:00)
 
我是newer,哪位好心人能告诉我该顺着哪把程序看下去，该怎么看，好吗？ ( mamason 发表于 2003-11-5 16:11:00)
 
请助：我的E—MAIL  [e-mail]
操作平台XP，VC++7。0
问题：编译键盘钩子DLL出现下列错误
//////////////////////////////////////
 
正在链接...
  正在创建库 .\Debug/hodll.lib 和对象 .\Debug/hodll.exp
hodll.obj : error LNK2019: 无法解析的外部符号 __imp__sndPlaySoundA@8 ，该符号在函数 "long __stdcall KeyboardProc(int,unsigned int,long)" (?KeyboardProc@@YGJHIJ@Z) 中被引用
.\Debug/hodll.dll : fatal error LNK1120: 1 个无法解析的外部命令



命令行：
正在创建临时文件“C:\DOCUME~1\wlt\LOCALS~1\Temp\RSP000031.rsp”，其内容为
[
/OUT:".\Debug/hodll.dll" /INCREMENTAL /NOLOGO /DLL /DEF:".\hodll.def" /IGNOREIDL /DEBUG /PDB:".\Debug/hodll.pdb" /SUBSYSTEM:WINDOWS /IMPLIB:".\Debug/hodll.lib" /MACHINE:I386




"Debug\StdAfx.obj"
"Debug\hodll.obj"
"Debug\hodll.res"
]
正在创建命令行“link.exe @C:\DOCUME~1\wlt\LOCALS~1\Temp\RSP000031.rsp”

( logo 发表于 2003-10-24 15:12:00)
 
文章写的条理很清楚，可算经典之作 ( aps-gwx 发表于 2003-8-11 17:27:00)
 
.......................................................

--------------------next---------------------