Wave Driver介绍-5（Waveform Audio Driver Test测试Case描述）

    因为要对Audio Driver做CETK测试，所以今天了解了一下CETK测试中Audio Driver Test相关的源代码，简单的对各个Case列写如下：

Test ID	Test Name	测试目的	测试方法
100	Build Verification Test	驱动验证	遍历BuildIn下的流驱动并尝试同时打开wavein和waveout
1000	Easy Playback	播放wav文件	调用wave api sndPlaySound来播放wav文件
2000	Playback Capabilities	检查wave out支持的格式	调用wave api waveOutGetDevCaps()来获取wave out支持的格式
2001	Playback	播放音频	以wave out支持的音频格式来播放sine音频数据
2002	Playback Notifications	测试放音过程中的Notification机制	在调用waveout api waveoutopen时，通过参数传递不同通知方式（CALLBACK_NULL/CALLBACK_EVENT/CALLBACK_THREAD/CALLBACK_FUNCTION/CALLBACK_WINDOW），测试程序接收到通知信息后，将会去计算所耗费的时间并和标准时间做对比
2003	Playback Using Extended Functions	放音的过程中使用扩展功能函数	放音的同时调用调整增益的扩展功能函数
2004	Playback Buffer Freed During Playback	放音的同时释放内存	开始放音后释放内存，等待放音结束并记录所耗费的时间，并和标准时间做对比
2005	Playback Sample Rate Reporting	输出放音所支持的格式及具体的参数	调用waveOutGetDevCaps获取waveout所支持的格式，并打印其具体的参数信息，包括Channel/Sample Rate/BitsPerSample等信息
2006	Playback Initial Latency	测试放音耗时（WAVE_FORMAT_1M08）	依次调用waveout api以WAVE_FORMAT_1M08格式播放4毫秒数据量，记录时间并和标准时间做对比
2007	Playback Initial Latencies Series	测试放音耗时（所有格式）	1. 测试所有格式下的放音耗时，包括WAVE_FORMAT_1M08到WAVE_FORMAT_48000S16间的所有格式，并和标准的值做比较，在对每一种放音格式进行测试的时候，会以2^n（n介于1和12之间）毫秒为放音时常； 2. 具体的测试原理和方法与2006一样；
2008	Playback Interoperability	创建wav文件并播放	该测试按照标准的wav文件格式，创建wav文件，包含了多个chunk，然后进行播放，测试过程中Abort，原因不详
3000	Capture Capabilities	检查wave in支持的格式	调用wave api waveInGetDevCaps()来获取wave in支持的格式
3001	Capture	录音	以wave in支持的各种音频格式来录音，录音时长为1秒
3002	Capture Notifications	测试录音过程中的Notification机制	在调用wavein api waveinopen时，通过参数传递不同通知方式（CALLBACK_NULL/CALLBACK_EVENT/CALLBACK_THREAD/CALLBACK_FUNCTION/CALLBACK_WINDOW），测试程序接收到通知信息后，将会去计算所耗费的时间并和标准时间做对比
3003	Capture Buffer Freed During Capture	录音过程中释放内存	开始录音后释放内存，等待录音结束并记录所耗费的时间，并和标准时间做对比（之前的项目上出现过Wave Driver中发生Data Abort的情况，类似的其它项目却没有出现，原因不详）
3006	Capture Initial Latency	测试录音耗时（WAVE_FORMAT_1M08）	依次调用wavein api以WAVE_FORMAT_1M08格式录制4毫秒数据量大小的数据，记录时间并和标准时间做对比
3007	Capture Initial Latencies Series	测试录音耗时（所有格式）	1. 测试所有格式下的录音耗时，包括WAVE_FORMAT_1M08到WAVE_FORMAT_48000S16间的所有格式，并和标准的值做比较，在对每一种录音格式进行测试的时候，会以2^n（n介于1和12之间）毫秒为录音时常； 2. 具体的测试原理和方法与3006一样；
3008	Capture Multiple Streams	多个stream同时录音	1.线程中调用waveInPrepareHeader成功后开始计时，然后调用waveInAddBuffer和waveInStart开始录音（录音时长为2秒），录音结束后记录时间并计算录音所耗费的时间，最后和标准的时长做对比； 2. 创建最多257个线程，每个线程中都重复上述的动作； 注： waveInPrepareHeader是阻塞式的么，当然不是，waveOutReset是阻塞式的
4000	Test Volume Control	测试混音器音量控制	测试混音器音量控制，目前的项目上不支持
4001	Test waveOutSetVolume & waveOutGetVolume	测试音量调整函数waveOutSetVolume	1. 函数waveOutSetVolume定义如下： MMRESULT WINAPI waveOutSetVolume(HWAVEOUT hwo, DWORD dwVolume); 2. 第一个参数hwo可以传入音频设备的ID号，即0/1等，也可以传入waveout操作Handle（通过waveOutOpen可以获取到Handle）; 3. 这个测试Case就是用来测试通过上述两种方式来调整音量； 注：     给函数waveOutSetVolume第一个参数传入设备号调整设备音量，而传入Stream句柄为调整Stream音量
5000	Test Power Down/Up with PlaySound Synchronus	播音时改变音频设备状态（PlaySound(…,SND_SYNC)）	1. 调用PlaySound(…,SND_SYNC)播音； 2. 调用SetKernelAlarm配置系统RTC唤醒，然后调用SetSystemPowerState(TEXT("Suspend"), NULL, POWER_FORCE)使系统进入Suspend，等待系统RTC唤醒成功； 3. 判断播音是否正常； 注： PlaySound(…,SND_SYNC)调用为阻塞式的，所以该测试没有意义
5001	Test Power Down/Up with PlaySound Asynchronus	播音时改变音频设备状态（PlaySound(…,SND_ASYNC)）	1. 调用PlaySound(…,SND_ASYNC)播音； 2. 调用SetKernelAlarm配置系统RTC唤醒，然后调用SetSystemPowerState(TEXT("Suspend"), NULL, POWER_FORCE)使系统进入Suspend，等待系统RTC唤醒成功； 3. 判断播音是否正常；
5002	Test Power Down/Up with sndPlaySound Synchronus	播音时改变音频设备状态（sndPlaySound(…,SND_SYNC)）	1. 调用sndPlaySound(…,SND_SYNC)播音； 2. 调用SetKernelAlarm配置系统RTC唤醒，然后调用SetSystemPowerState(TEXT("Suspend"), NULL, POWER_FORCE)使系统进入Suspend，等待系统RTC唤醒成功； 3. 判断播音是否正常； 注： sndPlaySound(…,SND_SYNC)调用为阻塞式的，所以该测试没有意义
5003	Test Power Down/Up with sndPlaySound Asynchronus	播音时改变音频设备状态（sndPlaySound(…,SND_ASYNC)）	1. 调用sndPlaySound(…,SND_ASYNC)播音； 2. 调用SetKernelAlarm配置系统RTC唤醒，然后调用SetSystemPowerState(TEXT("Suspend"), NULL, POWER_FORCE)使系统进入Suspend，等待系统RTC唤醒成功； 3. 判断播音是否正常；
5004	Test Power Down/Up with waveOutWrite	播音时改变音频设备状态（waveOutOpen/waveOutPrepareHeader/waveOutWrite）	1. 调用waveOutOpen/waveOutPrepareHeader/waveOutWrite播音； 2. 调用SetKernelAlarm配置系统RTC唤醒，然后调用SetSystemPowerState(TEXT("Suspend"), NULL, POWER_FORCE)使系统进入Suspend，等待系统RTC唤醒成功； 3. 判断播音是否正常；
6000	Playback Mixing	测试混音（播音）	1. 调用Wave out API播音； 2. 创建多个完成第一步功能的线程，并等待播音结束；
6001	Capture Mixing	测试混音（录音）	与6000测试类似，只不过是测试录音
7000	International Audio File Names	常见wav标准格式的文件并播放	1. 使用内建类CWaveFileEx创建wav文件并填充chunk； 2. 分别调用PlaySound和sndPlaySound播放；
8000	Verify Handle Validation	测试wave api	调用各种各样的wave api进行测试，确定api可用
8001	Verify Device ID Validation	测试Device ID	1. 获取录音和播音设备个数； 2. 通过调用waveOutGetDevCaps/waveInGetDevCaps并传入设备ID来确定该设备ID是否可用；
8002	Verify GUID Validation	测试GUID	调用waveOutGetProperty获取GUID，然后调用waveOutSetProperty写入

         以上仅仅是个人理解，可能有错误。