Gerenciando MIDI Thru

Você pode conectar um dispositivo de entrada MIDI diretamente a um dispositivo de saída MIDI para que, quando o dispositivo de entrada receber uma mensagem MIM_DATA , o sistema envie uma mensagem com os mesmos dados de evento MIDI para o driver de dispositivo de saída. Para conectar um dispositivo de saída MIDI a um dispositivo de entrada MIDI, use a função midiConnect .

Para obter o melhor desempenho possível com várias saídas, um aplicativo pode optar por fornecer uma forma especial de driver de saída MIDI, chamado de driver thru. Embora o sistema permita que apenas um dispositivo de saída MIDI seja conectado a um dispositivo de entrada MIDI, vários dispositivos de saída MIDI podem ser conectados a um driver por meio de . Um aplicativo em um sistema desse tipo poderia conectar o dispositivo de entrada MIDI a esse dispositivo por meio de e conectar o dispositivo MIDI por meio de quantos dispositivos de saída MIDI forem necessários. Para obter mais informações sobre drivers, consulte a documentação do driver de dispositivo windows.

Usando mensagens para gerenciar a gravação MIDI

As mensagens a seguir podem ser enviadas para um procedimento de retorno de chamada de janela ou thread para gerenciar a gravação MIDI.

Valor	Significado
MM_MIM_CLOSE	Enviado quando um dispositivo de entrada MIDI é fechado usando a função midiInClose .
MM_MIM_DATA	Enviado quando uma mensagem MIDI completa é recebida. (Essa mensagem é usada para todas as mensagens MIDI, exceto mensagens exclusivas do sistema.)
MM_MIM_ERROR	Enviado quando uma mensagem MIDI inválida é recebida. (Essa mensagem é usada para todas as mensagens MIDI, exceto mensagens exclusivas do sistema.)
MM_MIM_LONGDATA	Enviado quando uma mensagem completa exclusiva do sistema MIDI é recebida ou quando um buffer é preenchido com dados exclusivos do sistema.
MM_MIM_LONGERROR	Enviado quando uma mensagem exclusiva do sistema MIDI inválida é recebida.
MM_MIM_MOREDATA	Enviado quando um aplicativo não está processando mensagens MIM_DATA rápido o suficiente para acompanhar o driver de dispositivo de entrada.
MM_MIM_OPEN	Enviado quando um dispositivo de entrada MIDI é aberto usando a função midiInOpen .

 

Um parâmetro wParam e um parâmetro lParam estão associados a cada uma dessas mensagens. O parâmetro wParam sempre especifica o identificador de um dispositivo MIDI aberto. O parâmetro lParam não é usado para as mensagens MM_MIM_CLOSE e MM_MIM_OPEN .

Para a mensagem MM_MIM_LONGDATA , lpMidiHdr especifica um endereço de uma estrutura MIDIHDR que identifica o buffer para mensagens exclusivas do sistema. O buffer pode não ser completamente preenchido, pois o tamanho das mensagens exclusivas do sistema geralmente não é conhecido antes de ser gravado e porque buffers cujo tamanho total pode conter a maior mensagem esperada devem ser alocados. Para determinar a quantidade de dados válidos presentes no buffer, use o membro dwBytesRecorded da estrutura MIDIHDR .

Usando uma função de retorno de chamada para gerenciar a gravação MIDI

Você pode definir sua própria função de retorno de chamada para gerenciar a gravação para dispositivos de entrada MIDI. A função de retorno de chamada é documentada como MidiInProc.

As mensagens a seguir podem ser enviadas para o parâmetro wMsg da função de retorno de chamada MidiInProc .

Valor	Significado
MIM_CLOSE	Enviado quando o dispositivo é fechado usando a função midiInClose .
MIM_DATA	Enviado quando uma mensagem MIDI completa é recebida (essa mensagem é usada para todas as mensagens MIDI, exceto mensagens exclusivas do sistema).
MIM_ERROR	Enviado quando uma mensagem MIDI inválida é recebida (essa mensagem é usada para todas as mensagens MIDI, exceto mensagens exclusivas do sistema).
MIM_LONGDATA	Enviado quando uma mensagem completa exclusiva do sistema MIDI é recebida ou quando um buffer é preenchido com dados exclusivos do sistema.
MIM_LONGERROR	Enviado quando uma mensagem exclusiva do sistema MIDI inválida é recebida.
MIM_MOREDATA	Enviado quando um aplicativo não está processando mensagens MIM_DATA rápido o suficiente para acompanhar o driver de dispositivo de entrada.
MIM_OPEN	Enviado quando o dispositivo de entrada MIDI é aberto usando a função midiInOpen .

 

Essas mensagens são semelhantes às enviadas para funções de procedimento de janela, mas os parâmetros são diferentes. Um identificador do dispositivo MIDI aberto é passado como um parâmetro para a função de retorno de chamada, juntamente com a palavra dupla dos dados de instância que foram passados usando midiInOpen.

Para a mensagem MIM_LONGDATA , lpMidiHdr especifica um endereço de uma estrutura MIDIHDR que identifica o buffer para mensagens exclusivas do sistema. O buffer pode não estar completamente preenchido. Para determinar a quantidade de dados válidos presentes no buffer, use o membro dwBytesRecorded da estrutura MIDIHDR .

Depois que o driver de dispositivo for concluído com um bloco de dados, você poderá limpo e liberar o bloco de dados.

Tópicos relacionados

Gravando áudio MIDI