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;


 
   




//举例: