WinAPI: waveInAddBuffer - 向波形输入设备发送一个输入缓冲区

提示:
缓冲区写满后送回应用程序.
在缓冲区给 waveInAddBuffer 前, 先要调用 waveInPrepareHeader 准备; 还要调用 GlobalAlloc 给 TWaveHdr 和其中 lpData 指向的缓冲区分配内存(使用 GMEM_MOVEABLE、GMEM_SHARE), 并用 GlobalLock 锁定.

//声明:

WINMMAPI MMRESULT WINAPI waveInAddBuffer(HWAVEIN hwi, LPWAVEHDR pwh, UINT cbwh);
waveInAddBuffer(
hWaveIn: HWAVEIN; /* 波形输入设备句柄 */
lpWaveInHdr: PWaveHdr; /* TWaveHdr 结构的指针 */
uSize: UINT /* TWaveHdr 结构大小 */
): MMRESULT; /* 成功返回 0; 可能的错误值如下: */

MMSYSERR_INVALHANDLE = 5; /* 设备句柄无效 */
WAVERR_UNPREPARED = 34; /* 没准备好缓冲区 */
MMSYSERR_HANDLEBUSY = 12; /* 设备已被另一线程使用 */

//TWaveHdr 是 wavehdr_tag 结构的重定义
wavehdr_tag = record
lpData: PChar; /* 指向波形数据缓冲区 */
dwBufferLength: DWORD; /* 波形数据缓冲区的长度 */
dwBytesRecorded: DWORD; /* 若首部用于输入, 指出缓冲区中的数据量 */
dwUser: DWORD; /* 指定用户的32位数据 */
dwFlags: DWORD; /* 缓冲区标志 */
dwLoops: DWORD; /* 循环播放次数, 仅用于输出缓冲区 */
lpNext: PWaveHdr; /* 保留 */
reserved: DWORD; /* 保留 */
end;

//dwFlags 的可选值:
WHDR_DONE = $00000001; /* 设备已使用完缓冲区, 并返回给程序 */
WHDR_PREPARED = $00000002; /* waveInPrepareHeader 或 waveOutPrepareHeader 已将缓冲区准备好 */
WHDR_BEGINLOOP = $00000004; /* 缓冲区是循环中的第一个缓冲区, 仅用于输出 */
WHDR_ENDLOOP = $00000008; /* 缓冲区是循环中的最后一个缓冲区, 仅用于输出 */
WHDR_INQUEUE = $00000010; /* reserved for driver */