黑鳃刺尾鱼:函数PlaySound和sndPlaySound以及VA

函数PlaySound和sndPlaySound的用法

一.PlaySound函数的声明为：

BOOL PlaySound(LPCSTR pszSound,HMODULE hmod,DWORD fdwSound);

1.参数pszSound:是指定了要播放声音的字符串,该参数可以是WAVE文件的名字,或是WAVE资源的名字,或是内存中声音数据的指针,或是在系统注册表WIN.INI中定义的系统事件声音.如果该参数为NULL则停止正在播放的声音.

2.参数hmod:是应用程序的实例句柄,当播放WAV资源时要用到该参数,否则它必须为NULL.

3.参数fdwSound: 是标志的组合，如下表所示。若成功则函数返回TRUE，否则返回FALSE。
二．播放标志以及含义：

SND_APPLICATION
 用应用程序指定的关联来播放声音。

SND_ALIAS
 pszSound参数指定了注册表或WIN.INI中的系统事件的别名。

SND_ALIAS_ID
 pszSound参数指定了预定义的声音标识符。

SND_ASYNC
 用异步方式播放声音，PlaySound函数在开始播放后立即返回。

SND_FILENAME
 pszSound参数指定了WAVE文件名。

SND_LOOP
 重复播放声音，必须与SND_ASYNC标志一块使用。

SND_MEMORY
 播放载入到内存中的声音，此时pszSound是指向声音数据的指针。

SND_NODEFAULT
 不播放缺省声音，若无此标志，则PlaySound在没找到声音时会播放缺省声音。

SND_NOSTOP
 PlaySound不打断原来的声音播出并立即返回FALSE。

SND_NOWAIT
 如果驱动程序正忙则函数就不播放声音并立即返回。
SND_PURGE
 停止所有与调用任务有关的声音。若参数pszSound为NULL，就停止所有的声音，否则，停止pszSound指定的声音。
SND_RESOURCE
 pszSound参数是WAVE资源的标识符，这时要用到hmod参数。
SND_SYNC
 同步播放声音，在播放完后PlaySound函数才返回。

三．函数使用方法及代码：

注意：在使用函数前要加入：

#include "mmsystem.h"//导入声音头文件

#pragma comment(lib,"winmm.lib")//导入声音头文件库

１．直接播出声音文件：

PlaySound("c:\\win95\\media\\The Microsoft Sound.wav", NULL, SND_FILENAME | SND_ASYNC);
注意：参数中的路径使用两个连续的反斜杠转义代表一个反斜杠。

２．把声音文件加入到资源中，然后从资源中播放声音：

Visual C++支持WAVE型资源，用户在资源视图中单击鼠标右键并选择Import命令，然后在文件选择对话框中选择The Microsoft Sound.wav文件，则该文件就会被加入到WAVE资源中。假定声音资源的ID为IDR_STARTWIN，则下面的调用同样会输出启动声音：

PlaySound((LPCTSTR)IDR_STARTWIN, AfxGetInstanceHandle(), SND_RESOURCE | SND_ASYNC);

或：

PlaySound(MAKEINTRESOURCE(IDR_WAVE2),AfxGetResourceHandle(),SND_ASYNC|SND_RESOURCE|SND_NODEFAULT|SND_LOOP);//将声音文件写入到程序中
３．用PlaySound播放系统声音：

Windows启动的声音是由SystemStart定义的系统声音，因此可以用下面的方法播放启动声音：
PlaySound("SystemStart",NULL,SND_ALIAS|SND_ASYNC);
/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////               

sndPlaySound函数的声明为：
BOOL sndPlaySound(LPCSTR lpszSound, UINT fuSound);

用法：

除了不能指定资源名字外，参数lpszSound与PlaySound的是一样的。参数fuSound是如何播放声音的标志，可以是SND_ASYNC、SND_LOOP、SND_MEMORY、SND_NODEFAULT、SND_NOSTOP和SND_SYNC的组合，这些标志的含义与PlaySound的一样。
可以看出，sndPlaySound不能直接播放声音资源。要用该函数播放WAVE文件，可按下面的方式调用：
sndPlaySound("MYSOUND.WAV",SND_ASYNC); 

有关VA_LIST的用法

VA_LIST 是在C语言中解决变参问题的一组宏

VA_LIST的用法：
       （1）首先在函数里定义一具VA_LIST型的变量，这个变量是指向参数的指针
      （2）然后用VA_START宏初始化变量刚定义的VA_LIST变量，这个宏的第二个参数是第一个可变参数的前一个参数，是一个固定的参数。
       （3）然后用VA_ARG返回可变的参数，VA_ARG的第二个参数是你要返回的参数的类型。
       （4）最后用VA_END宏结束可变参数的获取。然后你就可以在函数里使用第二个参数了。如果函数有多个可变参数的，依次调用VA_ARG获取各个参数。
VA_LIST在编译器中的处理：

(1)在运行VA_START(ap,v)以后，ap指向第一个可变参数在堆栈的地址。
（2）VA_ARG()取得类型t的可变参数值，在这步操作中首先apt = sizeof(t类型)，让ap指向下一个参数的地址。然后返回ap-sizeof(t类型)的t类型*指针，这正是第一个可变参数在堆栈里的地址。然后用*取得这个地址的内容。
（3）VA_END(),X86平台定义为ap = ((char*)0)，使ap不再指向堆栈，而是跟NULL一样，有些直接定义为((void*)0)，这样编译器不会为VA_END产生代码，例如gcc在Linux的X86平台就是这样定义的。

要注意的是：由于参数的地址用于VA_START宏，所以参数不能声明为寄存器变量，或作为函数或数组类型。

使用VA_LIST应该注意的问题：
   （1）因为va_start, va_arg, va_end等定义成宏,所以它显得很愚蠢,可变参数的类型和个数完全在该函数中由程序代码控制,它并不能智能地识别不同参数的个数和类型. 也就是说,你想实现智能识别可变参数的话是要通过在自己的程序里作判断来实现的.
    （2）另外有一个问题,因为编译器对可变参数的函数的原型检查不够严格,对编程查错不利.不利于我们写出高质量的代码。

小结：可变参数的函数原理其实很简单，而VA系列是以宏定义来定义的，实现跟堆栈相关。我们写一个可变函数的C函数时，有利也有弊,所以在不必要的 场合，我们无需用到可变参数，如果在C++里，我们应该利用C++多态性来实现可变参数的功能，尽量避免用C语言的方式来实现。