在音频编程的世界里，C语言是一个强大的工具，尤其是当你想要进行音频录制时。waveinOpen 是WAV音频输入设备API中的一个关键函数，它负责打开一个音频输入设备，并设置回调函数，以便在音频数据可用时通知程序。本文将深入探讨 waveinOpen 回调，并为你提供一个音频录制的入门指南。

波形输入设备（WaveIn）简介

首先，让我们了解一下波形输入设备（WaveIn）。WaveIn 是一种Windows API，允许应用程序捕获来自麦克风或其他音频输入设备的音频数据。通过使用 WaveIn，你可以实现音频录制、编辑和播放等功能。

waveinOpen 函数

waveinOpen 函数是 WaveIn API 的核心，它负责初始化音频输入设备。这个函数的声明如下：

HHWAVEIN waveinOpen(HINSTANCE hinst, UINT uDeviceID, WAVEFORMATEX *lpwf, WAVEINCAPTUREPROC dwCallback, DWORD dwCallbackInstance, DWORD fdwOpenMode);
  • hinst：应用程序实例句柄。
  • uDeviceID：指定要打开的音频输入设备的索引。
  • lpwf：指向 WAVEFORMATEX 结构的指针，该结构定义了音频数据的格式。
  • dwCallback：指定一个回调函数，该函数将在音频数据可用时被调用。
  • dwCallbackInstance：回调函数实例句柄。
  • fdwOpenMode：指定打开模式。

waveinOpen 回调

回调函数是 waveinOpen 函数的最重要的参数之一。当音频数据准备好时，Windows 会自动调用这个回调函数。以下是回调函数的声明：

typedef DWORD (WINAPI *WAVEINCAPTUREPROC)(
    HWAVEIN hWaveIn,
    UINT uMsg,
    DWORD dwInstance,
    DWORD dwUser,
    DWORD dwParam1,
    DWORD dwParam2
);
  • hWaveIn：打开的波形输入设备句柄。
  • uMsg：指定消息类型。
  • dwInstance：回调函数实例句柄。
  • dwUser：由应用程序指定的用户定义的值。
  • dwParam1 和 dwParam2：与消息类型相关的参数。

音频录制入门指南

1. 准备工作

在开始录制音频之前，你需要准备以下几项：

  • 微型计算机
  • 音频输入设备（如麦克风）
  • C语言编译器

2. 编写代码

以下是一个简单的音频录制示例代码：

#include <windows.h>

// 回调函数
DWORD WINAPI waveInProc(HWaveIn hWaveIn, UINT uMsg, DWORD dwInstance, DWORD dwUser, DWORD dwParam1, DWORD dwParam2)
{
    switch (uMsg)
    {
        case WIM_OPEN:
            // 输入设备打开成功
            break;
        case WIM_DATA:
            // 音频数据可用
            break;
        case WIM_ERROR:
            // 发生错误
            break;
        case WIM_CLOSE:
            // 输入设备关闭
            break;
        default:
            break;
    }
    return 0;
}

int main()
{
    WAVEINCAPTUREPROC lpfnCallback = waveInProc;
    WAVEFORMATEX waveFormat;
    WAVEINCAPTUREPROC hWaveIn;

    // 初始化音频格式
    waveFormat.wFormatTag = WAVE_FORMAT_PCM;
    waveFormat.nChannels = 1;
    waveFormat.nSamplesPerSec = 44100;
    waveFormat.nAvgBytesPerSec = 44100 * 2;
    waveFormat.nBlockAlign = 2;
    waveFormat.wBitsPerSample = 16;
    waveFormat.cbSize = 0;

    // 打开音频输入设备
    hWaveIn = waveinOpen(NULL, 0, &waveFormat, lpfnCallback, 0, WAVEINCAPTUREOPEN | WAVEINCAPTURELOOP);

    if (hWaveIn == NULL)
    {
        MessageBox(NULL, "Open waveIn error!", "Error", MB_OK);
        return 0;
    }

    // 启动录制
    waveInStart(hWaveIn);

    // 等待一段时间
    Sleep(5000);

    // 停止录制
    waveInStop(hWaveIn);

    // 关闭音频输入设备
    waveInClose(hWaveIn);

    return 0;
}

3. 运行程序

编译并运行上述代码，程序将打开音频输入设备，并录制5秒钟的音频。录制完成后，程序将停止录制并关闭音频输入设备。

总结

通过本文，你了解了 waveinOpen 回调函数以及如何使用 C 语言进行音频录制。希望这个入门指南能帮助你开始自己的音频录制之旅。在音频编程的世界里，还有很多有趣的事情等待你去探索。