查詢 MIDI 輸出裝置

播放 MIDI 檔案之前,您應該使用 midiOutGetDevCaps 函式來判斷系統中存在 MIDI 輸出裝置的功能。 此函式會採用 MIDIOUTCAPS 結構的位址,它會填入指定裝置功能的相關資訊。 此資訊包括製造商和產品識別碼、裝置的產品名稱,以及 wMidwPidszPnamevDriverVersion 成員分別指定之裝置 (驅動程式的版本號碼) 。

MIDI 輸出裝置可以是內部合成器或外部 MIDI 輸出埠。 MIDIOUTCAPS結構的wTechnology成員會指定裝置的技術。

如果裝置是內部合成器, wVoiceswNoteswChannelMask 成員中會提供其他裝置資訊。 wVoices成員會指定裝置支援的語音數目。 每個聲音都可以有不同的音效或音調。 語音會組織成 MIDI 頻道。 wNotes成員會指定裝置的多邊音,也就是可以同時播放的筆記數目上限。 wChannelMask成員是裝置回應之 MIDI 通道的位標記法。 例如,如果裝置回應前八個 MIDI 通道, 則 wChannelMask 會0x00FF。 如果裝置是外部輸出埠, 則未使用 wVoiceswNotes而 wChannelMask 會設定為 0xFFFF。

MIDIOUTCAPS結構的dwSupport成員指出設備磁碟機是否支援磁片區變更、修補程式快取和串流。 只有內部合成器裝置才支援磁片區變更。 外部 MIDI 輸出埠不支援磁片區變更。 如需變更磁片區的相關資訊,請參閱 變更內部 MIDI 合成器磁片區