C++使用WaveOut API播放音频卡顿，恳请帮忙排查代码问题

代码核心错误点 #

• 双通道音频数据填充错误：你配置了2声道输出，但填充PCM数据时仅按单通道逻辑写入，每帧音频需要包含左右两个声道的采样值，实际填充的数据量仅为播放要求的一半，导致播放时数据断档卡顿。
• 初始缓冲区提交不足：启动播放前你仅调用了1次Write()，仅提交了1个缓冲块，剩余3个预分配的缓冲块从未提交给音频设备，播放完第一个块后才通过回调提交下一个块，中间存在明确的播放间隙。
• 缓冲区预处理逻辑冗余：对于固定不变的音频数据，仅需要在启动播放前对所有WAVEHDR执行一次waveOutPrepareHeader即可，你在回调中反复执行waveOutUnprepareHeader+waveOutPrepareHeader操作，额外占用系统时间，加剧时序错位风险。
• 全局变量无线程安全保护：U_BlockCurrent是全局变量，WaveOut的回调函数运行在系统独立线程，无锁修改会出现竞态条件，导致提交的缓冲块地址错误。
• 缓冲块时长过短：当前单块缓冲的播放时长仅约11ms，小于Windows系统常规线程调度时间片，容易出现调度不及时导致的断流，建议将单块缓冲的播放时长调整到20~50ms区间，对应44100Hz双通道场景下U_BlockSize设为2048以上即可。
• 主线程死循环占满CPU：while(true)空转占满单个CPU核心，会降低音频播放线程的调度优先级，进一步加剧卡顿，建议替换为带Sleep(10)的循环，主动让出CPU资源。
• 正弦波生成参数错误：你当前生成正弦波的频率计算不符合标准，要生成440Hz音频应该将步长改为2 * M_PI * 440 / U_SampleRate，不过该问题仅影响音高，不导致卡顿。

关键修复代码片段 #

1. 正确填充双通道PCM数据 #

// 每个采样帧包含2个short，分别对应左右声道，值可以相同
for (UINT FrameIdx = 0; FrameIdx < U_BlockCount * U_BlockSize / 2; FrameIdx++)
{
    double sample = OutPutWave() * 32767.0; // 16位采样的满幅是32767，不要随便设系数
    T_Memory[FrameIdx * 2 + 0] = (TYPE)sample; // 左声道
    T_Memory[FrameIdx * 2 + 1] = (TYPE)sample; // 右声道
}

2. 启动前提交所有缓冲块 #

// 启动前一次性prepare所有缓冲块，再全部提交
for (UINT Idx = 0; Idx < U_BlockCount; Idx++)
{
    ParseError(waveOutPrepareHeader(H_Waveout, &W_Header[Idx], sizeof(WAVEHDR)), L"waveOutPrepareHeader");
    ParseError(waveOutWrite(H_Waveout, &W_Header[Idx], sizeof(WAVEHDR)), L"waveOutWrite");
}

3. 简化回调逻辑 #

void CALLBACK waveOutProc(HWAVEOUT Waveout, UINT uMsg, DWORD_PTR dwInstance, DWORD_PTR dwParam1, DWORD_PTR dwParam2)
{
    if (uMsg == WOM_DONE) 
    {
        // 播放完成的缓冲块直接重新提交即可，不需要反复prepare/unprepare
        WAVEHDR* pDoneHdr = (WAVEHDR*)dwParam1;
        ParseError(waveOutWrite(Waveout, pDoneHdr, sizeof(WAVEHDR)), L"waveOutWrite");
    }
}

内容的提问来源于stack exchange，提问作者Gijahara