Consultando dispositivos de saída MIDI

Antes de reproduzir um arquivo MIDI, você deve usar a função demidiOutGetDevCapspara determinar os recursos do dispositivo de saída MIDI presente no sistema. Esta função recebe um endereço de uma estrutura MIDIOUTCAPS, que preenche com informações sobre as capacidades do dispositivo fornecido. Essas informações incluem o fabricante e os identificadores do produto, um nome de produto para o dispositivo e o número da versão do driver de dispositivo (especificado, respectivamente, nos membros wMid, wPid, szPname, e vDriverVersion).

Os dispositivos de saída MIDI podem ser sintetizadores internos ou portas de saída MIDI externas. O membro wTechnology da estrutura MIDIOUTCAPS especifica a tecnologia do dispositivo.

Se o dispositivo for um sintetizador interno, informações adicionais do dispositivo estarão disponíveis nos membros wVoices, wNotese wChannelMask. O membro wVoices especifica o número de vozes suportadas pelo dispositivo. Cada voz pode ter um som ou timbre diferente. As vozes estão organizadas em canais MIDI. O membro wNotes especifica o de polifonia do dispositivo — ou seja, o número máximo de notas que podem ser reproduzidas simultaneamente. O membro wChannelMask é uma representação em bits dos canais MIDI aos quais o dispositivo responde. Por exemplo, se o dispositivo responde aos primeiros oito canais MIDI, o valor de wChannelMask é 0x00FF. Se o dispositivo for uma porta de saída externa, wVoices e wNotes não são utilizados, e wChannelMask está definido como 0xFFFF.

O membro dwSupport da estrutura MIDIOUTCAPS indica se o driver de dispositivo suporta alterações de volume, armazenamento em cache de patches e streaming. As alterações de volume são suportadas apenas por dispositivos de sintetizador internos. As portas de saída MIDI externas não suportam alterações de volume. Para obter informações sobre como alterar o volume, consulte Alterando o volume interno do sintetizador MIDI.