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

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

---

//声明:

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 }


 
   




//举例: