使用WindowsAPI获取录音音频

本文实例介绍了使用winmm.h进行音频流的获取的方法，具体步骤如下：

一、首先需要包含以下引用对象

1

2

3

#include <Windows.h>
#include "mmsystem.h"
#pragma comment(lib, "winmm.lib")

二、音频的获取需要调用7个函数

1. waveInGetNumDevs：返回系统中就绪的波形声音输入设备的数量

1	`UINT` `waveInGetNumDevs(VOID);`

2. waveInGetDevCaps：检查指定波形输入设备的特性

MMRESULT waveInGetDevCaps( 
 UINT_PTR   uDeviceID, 
 LPWAVEINCAPS pwic,    
 UINT     cbwic    
);
//uDeviceID 音频输入设备标识,也可以为一个打开的音频输入设备的句柄.
//  个人认为如果上一步获得了多个设备，可以用索引标识每一个设备.
//  
//pwic 对WAVEINCAPS结构体的一个指针,包含设备的音频特性.
//
//cbwic WAVEINCAPS结构体的大小,使用sizeof即可.
//
//MMRESULT 函数执行的结果
//  MMSYSERR_NOERROR 表示执行成功
//  MMSYSERR_BADDEVICEID 索引越界 
//  MMSYSERR_NODRIVER 没有就绪的设备 
//  MMSYSERR_NOMEM 不能分配或者锁定内存

介绍WAVEINCAPS结构体的含义：

typedef struct { 
  WORD   wMid;        //音频设备制造商定义的驱动程序标识
  WORD   wPid;        //音频输入设备的产品标识
  MMVERSION vDriverVersion;    //驱动程序版本号
  TCHAR   szPname[MAXPNAMELEN];//制造商名称
  DWORD   dwFormats;      //支持的格式,参见MSDN
  WORD   wChannels;      //支持的声道数
  WORD   wReserved1;      //保留参数
} WAVEINCAPS;

3. waveInOpen：打开指定的音频输入设备，进行录音

MMRESULT waveInOpen(
 LPHWAVEIN    phwi,        //接收打开的音频输入设备标识的HWAVEIN结构的指针
 UINT_PTR    uDeviceID,      //指定一个需要打开的设备标识.可以使用WAVE_MAPPER选择一个按指定录音格式录音的设备
 LPWAVEFORMATEX pwfx,        //一个所需的格式进行录音的WAVEFORMATEX结构的指针 
 DWORD_PTR   dwCallback,    //指向一个回调函数、事件句柄、窗口句柄、线程标识,对录音事件进行处理.
 DWORD_PTR   dwCallbackInstance, //传给回调机制的参数
 DWORD     fdwOpen      //打开设备的方法标识,指定回调的类型.参见CSDN
);

介绍WAVEFORMATEX结构体的含义：

typedef struct { 
  WORD wFormatTag;    //波形声音的格式,单声道双声道使用WAVE_FORMAT_PCM.当包含在WAVEFORMATEXTENSIBLE结构中时,使用WAVE_FORMAT_EXTENSIBLE.
  WORD nChannels;    //声道数量
  DWORD nSamplesPerSec;  //采样率.wFormatTag为WAVE_FORMAT_PCM时,有8.0kHz,11.025kHz,22.05kHz,和44.1kHz.
  DWORD nAvgBytesPerSec;  //每秒的采样字节数.通过nSamplesPerSec * nChannels * wBitsPerSample / 8计算
  WORD nBlockAlign;    //每次采样的字节数.通过nChannels * wBitsPerSample / 8计算
  WORD wBitsPerSample;  //采样位数.wFormatTag为WAVE_FORMAT_PCM时,为8或者16
  WORD cbSize;      //wFormatTag为WAVE_FORMAT_PCM时,忽略此参数
} WAVEFORMATEX;

介绍dwCallback回调函数格式：

1

2

3

4

5

6

7

void CALLBACK waveInProc(
 HWAVEIN hwi,     //回调此函数的设备句柄
 UINT uMsg,      //波形声音输入信息,标识关闭(WIM_CLOSE)、缓冲区满(WIM_DATA)、打开(WIM_OPEN).
 DWORD_PTR dwInstance, //用户在waveInOpen指定的数据
 DWORD_PTR dwParam1,  //(LPWAVEHDR)dwParam1,用户指定的缓冲区
 DWORD_PTR dwParam2   
);

4. waveInPrepareHeader：为音频输入设备准备一个缓冲区

1

2

3

4

5

MMRESULT waveInPrepareHeader(
 HWAVEIN hwi,  //音频输入设备句柄
 LPWAVEHDR pwh,//指向WAVEHDR结构的指针,标识准备的缓冲区
 UINT cbwh    //WAVEHDR结构的大小,使用sizeof即可
);

介绍WAVEHDR结构：

typedef struct wavehdr_tag { 
  LPSTR   lpData;     //指向波形格式的缓冲区
  DWORD   dwBufferLength; //缓冲区的大小
  DWORD   dwBytesRecorded; //当前存储了多少数据
  DWORD_PTR dwUser;     //用户数据
  DWORD   dwFlags;      //为缓冲区提供的信息,在waveInPrepareHeader函数中使用WHDR_PREPARED
  DWORD   dwLoops;     //输出时使用,标识播放次数
  struct wavehdr_tag * lpNext;//reserved
  DWORD_PTR reserved;     //reserved
} WAVEHDR, *LPWAVEHDR; 

5. waveInAddBuffer：将缓冲区发送给设备，若缓冲区填满，则不起作用。（参数同上）

1

2

3

4

5

MMRESULT waveInAddBuffer(
 HWAVEIN hwi, 
 LPWAVEHDR pwh, 
 UINT cbwh 
); 

6. waveInStart：开始进行录制

1

2

3

MMRESULT waveInStart(
 HWAVEIN hwi //设备句柄
);

7. waveInClose：关闭设备

1

2

3

MRESULT waveInClose(
 HWAVEIN hwi //设备句柄
);

三、完整实例代码如下: