MIDI音频函数.doc

MIDI低层音频函数编程 利用低层MIDI音频函数可是实现对MIDI设备的查询、MIDI音频播放与MIDI录音。 播放MIDI音频 播放MIDI音频的过程与播放波形音频的过程类似，其基本流程如下：① 播放MIDI音频前应先查询系统是否具备播放MIDI音频的设备，这可通过调用函数midiOutGetNumDevs来实现，该函数返回值为进行音频播放的设备数量。 ② 读出RIFF格式的MIDI文件，将MIDI文件中的事件信息组织好。 ③ 调用midiOutGetDevCaps，检查MIDI音频输出设备的性能，该函数的原型定义如下： MMRESULT midiOutGetDevCaps( UINT uDeviceID, LPMIDIOUTCAPS lpMidiOutCaps, UINT cbMidiOutCaps ); uDeviceID为需检查的设备号或设备句柄 lpMidiOutCaps为指向 MIDIOUTCAPS 结构的指针。该结构说明了MIDI输出设备的性能。其定义如下： typedef struct { WORD wMid; // 生产厂家ID WORD wPid; // 产品ID MMVERSION vDriverVersion; // 驱动程序版本号 CHAR szPname[MAXPNAMELEN]; // 产品名称 WORD wTechnology; // 设备的类型 WORD wVoices; // 设备的复音数 WORD wNotes; // 设备可同时演奏的音符数 WORD wChannelMask; // 设备的MIDI通道数 DWORD dwSupport; // 所支持的特征 } MIDIOUTCAPS; 其中wTechnology说明了MIDI输出设备的类型，其值可能是： MOD_FMSYNTH // FM合成器 MOD_MAPPER // Microsoft MIDI映射器 MOD_MIDIPORT // MIDI硬件端口 MOD_SQSYNTH // 平方波形合成器 MOD_SYNTH // 合成器 dwSupport说明了设备支持的其他功能特征，可为如下特征之一： MIDICAPS_CACHE // 支持音色高速缓存 MIDICAPS_LRVOLUME // 支持分离的左右音量控制 MIDICAPS_STREAM // 直接支持midiStreamOut 函数 MIDICAPS_VOLUME // 支持音量控制 ④ 调用midiOutOpen函数，打开MIDI输出设备，midiOutOpen的函数原型如下： MMRESULT midiOutOpen( LPHMIDIOUT lphmo, // 设备句柄指针 UINT uDeviceID, // 设备ID DWORD dwCallback, // 处理音频输出的回调函数地址 DWORD dwCallbackInstance, // 传给回调机制的用户实例 DWORD fdwOpen // 打开设备的标志 ); 设备打开成功后，lphmo将指向MIDI音频输出设备句柄HMIDIOUT，该句柄是后续对设备进行操作的对象。 当指定uDeviceID 为MIDI_MAPPER 时，函数将自动选取能播放MIDI的设备，并打开它。 fdwOpen可为下列的一个或多个标志的组合： CALLBACK_EVENT 说明dwCallback参数是一个事件句柄 CALLBACK_FUNCTION 说明dwCallback参数是回调函数地址 CALLBACK_NULL 说明没有回调机制，这是默认值 CALLBACK_THREAD 说明dwCallback参数是线程ID CALLBACK_WINDOW 说明dwCallback参数是窗口句柄 简单的解释下回调函数到底是怎么样的函数：使用回调函数实际上就是在调用某个函数（通常是API函数）时，将自己的一个函数（这个函数为回调函数）的地址作为参数传递给那个函数，而那个函数在需要的时候，利用传递的地址调用回调函数，这时你可以利用这个机会在回调函数中处理消息或完成一定的操作，回调函数一般由系统调用 ⑤ 打开音频输出设备，获得设备句柄后，调midiOutPrepareHeader，生成MIDI音频信息头结构，midiOutPrepareHeader的函数原型如下： MMRESULT midiOutPrepareHeader( HMIDIOUT hmo, // 设备句柄 LP