PlaySound函数
PlaySound 是 Windows 系统提供的基本音频播放函数,在 C/C++中使用。PlaySound 函数不仅能够播放波形音频文件,而且可以播放系统事件对应的音频(系统事件所关联的音频由注册表或 WIN.INI 文件确定)。
PlaySound 函数原型
其中,第一个参数 pszSound 是一个字符串变量,指向播放的波形音频文件。pszSound 可以为 NULL,这时任何当前播放的音频将停止,这实际上就是用 PlaySound 函数控制停止播放的基本方式。
第二个参数 hmod 是一个可执行文件的句柄,该可执行文件包含了需要加载的资源。一般情况下,hmod 被设置为NULL;如果第三个参数 fdwSound 设置成SND_RESOURCE,hmod 则设置为一个可执行文件的句柄。
第三个参数 fdwSound 是播放标识,有 15 种取值,例如,SDN_ASYNC 表示异步播放,即调用 PlaySound函数后声音开始播放,而调用立即返回,无需等待播放完毕。相反,SDN_SYNC 表示同步播放,即调用要在播放完毕后才能返回。fdwSound 的其它取值可参见 MSDN 文档。
另外,这里需要指出,第一个参数 pszSound与第三个参数 fdwSound还有关联,例如,如果 fdwSound 设置为SND_ALIAS,则 pszSound不能是文件名,而必须是注册的事件别名。
使用
PlaySound 函数在 mmsystem.h 头文件中声明,在winmm.lib 库文件中实现。因此,在程序设计中,应当将 mmsystem.h 头文件包含到使用 PlaySound 函数的程序文件中,同时,将 winmm.lib 库文件链接到 项目的属性中。