MIDI编曲

MIDI编曲

低阶MIDI的API包括字首为midiIn和midiOut的函式，它们分别用於读取来自外部控制器的MIDI序列和在内部或外部的合成器上播放音乐。尽管其名称为「低阶」，但使用这些函式时并不需要了解MIDI卡上的硬体介面。 要在播放音乐的准备期间打开一个MIDI输出设备，可以呼叫midiOutOpen函式： error = midiOutOpen (&hMidiOut, wDeviceID, dwCallBack,                              dwCallBackData, dwFlags) ; 如果呼叫成功，则函式传回0，否则传回错误代码。如果参数设定正确，则常见的一种错误就是MIDI设备已被其他程式使用。 该函式的第一个参数是指向HMIDIOUT型态变数的指标，它接收後面用於MIDI输出函式的MIDI输出代号。第二个参数是设备ID。要使用真实的 MIDI设备，这个参数范围可以是从0到小於由midiOutGetNumDevs传回的数值。您还可以使用MIDIMAPPER，它在 MMSYSTEM.H中定义为-1。大多数情况下，函式的後三个参数设定为NULL或0。 一旦打开一个MIDI输出设备并获得了其代号，您就可以向该设备发送MIDI讯息。此时可以呼叫： error = midiOutShortMsg (hMidiOut, dwMessage) ; 第一个参数是从midiOutOpen函式获得的代号。第二个参数是包装在32位元DWORD中的1位元组、2位元组或者3位元组的讯息。我在前面讨论过，MIDI讯息以状态位元组开始，後面是0、1或2位元组的资料。在dwMessage中，状态位元组是最不重要的，第一个资料位元组次之，第二个资料位元组再次之，最重要的位元组是0。 例如，要在MIDI通道5上以0x7F的速度演奏中音C（音符是0x3C），则需要3位元组的Note On讯息： 0x95 0x3C 0x7F midiOutShortMsg的参数dwMessage等于0x007F3C95。 三个基础的MIDI讯息是Program Change（可为某一特定通道而改变乐器声音）、Note On和Note Off。打开一个MIDI输出设备後，应该从一条Program Change讯息开始，然後发送相同数量的Note On和Note Off讯息。 当您一直演奏您想演奏的音乐时，您可以重置MIDI输出设备以确保关闭所有的音符： midiOutReset (hMidiOut) ; 然後关闭设备： midiOutClose (hMidiOut) ; 使用低阶的MIDI输出API时，midiOutOpen、midiOutShortMsg、midiOutReset和midiOutClose是您需要的四个基础函式。 现在让我们演奏一段音乐。BACHTOCC，如程式22-8所示，演奏了J. S. Bach著名的风琴演奏的D小调《Toccata and Fugue》中托卡塔部分的第一小节。