windows下使用waveOut播放音频pcm

目录

一、前言

二、waveOut主要API介绍

三、waveOut播放PCM音频框架

《Windows平台使用waveOut播放PCM数据代码实现》链接：

https://edu.csdn.net/learn/38258/606147?spm=1003.2001.3001.4157

一、前言

       在<windows下directShow音视频采集>一篇文章中就介绍了windows下通过directShow音视频采集的流程。windows下directShow不仅可以对音进行采也可以对音频进行播放，但是directShow使用过程较为复杂，所以本文将介绍windows下使用WAVE播放音频的过程。在微软的官方SDK文档说明中就对WAVE播放音频的API做了详细的介绍，连接为<wave播放音频的API介绍>。

二、waveOut主要API介绍

1、waveOutOpen()

        waveOutOpen函数的详细定义如下，该函数用于打开用于播放音频的输出设备。

MMRESULT waveOutOpen(
  LPHWAVEOUT      phwo,
  UINT            uDeviceID,
  LPCWAVEFORMATEX pwfx,
  DWORD_PTR       dwCallback,
  DWORD_PTR       dwInstance,
  DWORD           fdwOpen
);

     参数是phwo是存放wave音频输出设备的句柄的指针；

     参数uDeviceID是wave设备标识ID,当参数为WAVE_MAPPER时候标识可以播放给定格式的音频数据。

    参数pwfx用于设置要播放的音频数据格式。其结构体类型WAVEFORMATEX定义如下。

typedef struct tWAVEFORMATEX
{
    WORD        wFormatTag;         /* format type */
    WORD        nChannels;          /* number of channels (i.e. mono, stereo...) */
    DWORD       nSamplesPerSec;     /* sample rate */
    DWORD       nAvgBytesPerSec;    /* for buffer estimation */
    WORD        nBlockAlign;        /* block size of data */
    WORD        wBitsPerSample;     /* number of bits per sample of mono data */
    WORD        cbSize;             /* the count in bytes of the size of */
                                    /* extra information (after cbSize) */
} WAVEFORMATEX；

      参数dwCallback用于指定回调的机制；当前支持的回调机制包含如下;

指向回调函数的指针	A pointer to a callback function
窗口的句柄	A handle to a window
线程标识符	A thread identifier
事件的句柄	A handle to an event
值为 NULL	NULL

     参数dwInstance用于传递给回调机制的用户实例数据。

     参数fdwOpen用于打开设备的标志。其值如下(部分)

Value	含义
CALLBACK_EVENT	dwCallback 参数是事件句柄。
CALLBACK_FUNCTION	dwCallback 参数是回调过程地址。
CALLBACK_NULL	无回调机制。 这是默认设置。
CALLBACK_THREAD	dwCallback 参数是线程标识符。
CALLBACK_WINDOW	dwCallback 参数是窗口句柄。

2、waveOutPrepareHeader()

      waveOutPrepareHeader函数的定义如下，该函数用于准备wave音频数据块以供播放。

MMRESULT waveOutPrepareHeader(
  HWAVEOUT  hwo,
  LPWAVEHDR pwh,
  UINT      cbwh
);

      参数hwo为wave音频输出设备的句柄，即waveOutOpen的第一个参数值。

      参数pwh指向要发送的音频数据。其结构体定义如下。

/* wave data block header */
typedef struct wavehdr_tag {
    LPSTR       lpData;                 /* pointer to locked data buffer */
    DWORD       dwBufferLength;         /* length of data buffer */
    DWORD       dwBytesRecorded;        /* used for input only */
    DWORD_PTR   dwUser;                 /* for client's use */
    DWORD       dwFlags;                /* assorted flags (see defines) */
    DWORD       dwLoops;                /* loop control counter */
    struct wavehdr_tag FAR *lpNext;     /* reserved for driver */
    DWORD_PTR   reserved;               /* reserved for driver */
} WAVEHDR；

       参数cbwh为WAVEHDR 结构的大小，通常取值为sizeof(WAVEHDR)。

3、waveOutWrite()

       waveOutWrite函数的定义如下，该函数用于发送一个数据给音频播放设备。

MMRESULT waveOutWrite(
  HWAVEOUT  hwo,
  LPWAVEHDR pwh,
  UINT      cbwh
);

    参数hwo为wave音频输出设备的句柄，即waveOutOpen的第一个参数值。

    参数pwh指向要发送的音频数据。

    参数cbwh为WAVEHDR 结构的大小，通常取值为sizeof(WAVEHDR)。

  4、除了上诉三个API，在使用wave播放PCM音频还会用到CreateEvent、CloseHandle和WaitForSingleObject函数。CreateEvent用于创建事件。CloseHandle用于关闭事件。WaitForSingleObject用于观察线程信号状态，当线程信号状态为事件则返回；其定义如下

WaitForSingleObject(
    _In_ HANDLE hHandle,
    _In_ DWORD dwMilliseconds
    );

      参数hHandle为CreateEvent创建事件的句柄；

      参数dwMilliseconds为超时等待的参数。

5、waveOutClose(_In_ HWAVEOUT hwo)

     该函数用于关闭已经打开的wave音频播放设备。

     参数hwo为wave音频输出设备的句柄；

三、waveOut播放PCM音频框架