双缓冲waveOutWrite()播放卡顿及爆音问题（已解决）

谜团已解决，下面直接给出问题分析和针对性解决方案：

我尝试用Windows waveOut*()函数编写的Windows音调生成器。我严格按照MSDN文档要求实现（如手动重置回调事件等），但始终无法实现平滑方波播放——实际任何平滑播放都无法达成，为简化演示以方波为例，缓冲边界始终伴随爆音。

作为经常折腾Windows音频API的开发者，我太懂这种爆音的头疼了！哪怕严格跟着MSDN走，也容易忽略几个关键细节，导致缓冲衔接处的波形跳变。下面是能解决问题的核心步骤：

• 核心：保持方波相位连续
  方波的平滑播放完全依赖相位的无缝衔接。你需要维护一个全局的相位变量（比如double current_phase），每次填充新缓冲时，从这个相位开始计算方波的高低电平，填充完成后更新current_phase为当前缓冲结束时的相位值。如果每个缓冲都从零相位开始生成方波，两个缓冲的波形在衔接处必然会出现电平跳变，直接产生爆音。

• 优化缓冲循环与回调逻辑
  使用3-4个小缓冲组成循环队列，而不是单个大缓冲。在waveOutProc回调处理WOM_DONE消息时，先填充当前完成的缓冲的新数据，再调用waveOutWrite提交，最后重置事件——顺序很重要！如果先重置事件再提交，可能会导致waveOut提前触发下一个回调，引发时序问题。另外，缓冲大小建议设为采样率的1/10到1/20（比如44100Hz采样率用4410或2205大小的缓冲），平衡延迟和平滑度。

• 校验波形格式参数
  检查你的WAVEFORMATEX结构：

  • nBlockAlign必须正确（单声道16位的话是2，立体声16位是4）
  • nSamplesPerSec和wBitsPerSample要和你生成方波的参数一致
    参数不匹配会让waveOut错误解析缓冲数据，间接导致爆音。

• 规范缓冲数据填充
  填充缓冲时，严格按照缓冲的字节大小计算样本数，不要出现填充不足或溢出的情况。比如16位单声道缓冲，每个样本是2字节，那么样本数 = 缓冲字节数 / 2。方波的电平要严格落在格式允许的范围内（16位是-32768到32767），避免出现超出范围的硬削波。

按照这些步骤调整后，缓冲边界的爆音应该就能彻底消除，实现平滑的方波播放。

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