WinAPI: waveInOpen 打开波形输入设备

提示: 因为其中的回调函数是在中断时间内访问的, 必须在 DLL 中; 要访问的数据都必须是在固定的数据段中; 除了
PostMessage
timeGetSystemTime
timeGetTime
timeSetEvent
timeKillEvent
midiOutShortMsg
midiOutLongMsg
OutputDebugString 外, 也不能有其他系统调用.

---

//声明:
waveInOpen(
  lphWaveIn: PHWAVEIN;       {用于返回设备句柄的指针; 如果 dwFlags=WAVE_FORMAT_QUERY, 这里应是 nil}
  uDeviceID: UINT;           {设备ID; 可以指定为: WAVE_MAPPER, 这样函数会根据给定的波形格式选择合适的设备}
  lpFormatEx: PWaveFormatEx; {TWaveFormat 结构的指针; TWaveFormat 包含要申请的波形格式}
  dwCallback: DWORD          {回调函数地址或窗口句柄; 若不使用回调机制, 设为 nil}
  dwInstance: DWORD          {给回调函数的实例数据; 不用于窗口}
  dwFlags: DWORD             {打开选项}
): MMRESULT;                 {成功返回 0; 可能的错误值见下:}

MMSYSERR_BADDEVICEID = 2;  {设备ID超界}
MMSYSERR_ALLOCATED   = 4;  {指定的资源已被分配}
MMSYSERR_NODRIVER    = 6;  {没有安装驱动程序}
MMSYSERR_NOMEM       = 7;  {不能分配或锁定内存}
WAVERR_BADFORMAT     = 32; {设备不支持请求的波形格式}

//TWaveFormatEx 结构:
TWaveFormatEx = packed record
  wFormatTag: Word;       {指定格式类型; 默认 WAVE_FORMAT_PCM = 1;}
  nChannels: Word;        {指出波形数据的声道数; 单声道为 1, 立体声为 2}
  nSamplesPerSec: DWORD;  {指定采样频率(每秒的样本数)}
  nAvgBytesPerSec: DWORD; {指定数据传输的传输速率(每秒的字节数)}
  nBlockAlign: Word;      {指定块对齐(每个样本的字节数), 块对齐是数据的最小单位}
  wBitsPerSample: Word;   {采样大小(字节), 每个样本的量化位数}
  cbSize: Word;           {附加信息的字节大小}
end;
{16 位立体声 PCM 的块对齐是 4 字节(每个样本2字节, 2个通道)}

//打开选项 dwFlags 的可选值:
WAVE_FORMAT_QUERY = $0001;     {只是判断设备是否支持给定的格式, 并不打开}
WAVE_ALLOWSYNC    = $0002;     {当是同步设备时必须指定}
CALLBACK_WINDOW   = $00010000; {当 dwCallback 是窗口句柄时指定}
CALLBACK_FUNCTION = $00030000; {当 dwCallback 是函数指针时指定}

//如果选择窗口接受回调信息, 可能会发送到窗口的消息有:
MM_WIM_OPEN  = $3BE;
MM_WIM_CLOSE = $3BF;
MM_WIM_DATA  = $3C0;

//如果选择函数接受回调信息, 可能会发送给函数的消息有:
WIM_OPEN  = MM_WIM_OPEN;
WIM_CLOSE = MM_WIM_CLOSE;
WIM_DATA  = MM_WIM_DATA;


//举例: