Udostępnij przez


Wykonywanie zapytań dotyczących urządzeń wyjściowych MIDI

Przed rozpoczęciem odtwarzania pliku MIDI należy użyć funkcji midiOutGetDevCaps, aby określić możliwości urządzenia wyjściowego MIDI, które znajduje się w systemie. Funkcja ta przyjmuje adres struktury MIDIOUTCAPS, którą wypełnia informacjami o możliwościach danego urządzenia. Te informacje obejmują identyfikatory producenta i produktu, nazwę produktu dla urządzenia oraz numer wersji sterownika urządzenia (określony odpowiednio w wMid, wPid, szPnamei vDriverVersion elementów).

Urządzenia wyjściowe MIDI mogą być wewnętrznymi syntezatorami lub zewnętrznymi portami wyjściowymi MIDI. Element wTechnology struktury MIDIOUTCAPS określa technologię urządzenia.

Jeśli urządzenie jest wewnętrznym syntetyzatorem, dodatkowe informacje o urządzeniu są dostępne w wVoices, wNotesi wChannelMask polach. Członek wVoices określa liczbę głosów obsługiwanych przez urządzenie. Każdy głos może mieć inny dźwięk lub barwę. Głosy są zorganizowane w kanały MIDI. Element członkowski programu wNotes określa polifonię urządzenia — czyli maksymalną liczbę nut, które można zagrać jednocześnie. Element wChannelMask jest bitowym przedstawieniem kanałów MIDI, na które reaguje urządzenie. Na przykład, jeśli urządzenie odpowiada na pierwsze osiem kanałów MIDI, wChannelMask wynosi 0x00FF. Jeśli urządzenie jest zewnętrznym portem wyjściowym, wVoices i wNotes są nieużywane, a wChannelMask jest ustawiona na 0xFFFF.

Struktura dwSupport element MIDIOUTCAPS wskazuje, czy sterownik urządzenia obsługuje zmiany poziomu głośności, buforowanie łatki i przesyłanie strumieniowe. Zmiany woluminu są obsługiwane tylko przez wewnętrzne urządzenia syntetyzatora. Zewnętrzne porty wyjściowe MIDI nie obsługują zmian głośności. Aby uzyskać informacje o zmienianiu głośności, zobacz Zmiana wewnętrznego woluminu syntezatora MIDI.