Compartilhar via


MIM_MOREDATA mensagem

A mensagem MIM_MOREDATA é enviada para uma função de retorno de chamada de entrada MIDI quando uma mensagem MIDI é recebida por um dispositivo de entrada MIDI, mas o aplicativo não está processando mensagens MIM_DATA rápido o suficiente para acompanhar o driver do dispositivo de entrada. A função de retorno de chamada recebe essa mensagem somente quando o aplicativo especifica MIDI_IO_STATUS na chamada para a função midiInOpen .

MIM_MOREDATA 
dwParam1 = dwMidiMessage 
dwParam2 = dwTimestamp 

Parâmetros

dwMidiMessage

Especifica a mensagem MIDI que foi recebida. A mensagem é empacotada em um valorDWORDda seguinte maneira:

Requisito Valor Descrição
Palavra alta Byte de alta ordem Não usado.
Byte de baixa ordem Contém um segundo byte de dados MIDI (quando necessário).
Palavra baixa Byte de alta ordem Contém o primeiro byte de dados MIDI (quando necessário).
Byte de baixa ordem Contém o status MIDI.

Os dois bytes de dados MIDI são opcionais, dependendo do byte de status MIDI.

dwTimestamp

Especifica a hora em que a mensagem foi recebida pelo driver do dispositivo de entrada. O carimbo de data/hora é especificado em milissegundos, começando em 0 quando a função midiInStart foi chamada.

Valor Retornado

Esta mensagem não retorna um valor.

Comentários

Um aplicativo deve fazer apenas uma quantidade mínima de processamento de mensagens MIM_MOREDATA. (Em particular, os aplicativos não devem chamar a função PostMessage durante o processamento MIM_MOREDATA.) Em vez disso, o aplicativo deve colocar os dados do evento em um buffer e, em seguida, retornar.

Quando um aplicativo recebe uma mensagem de MIM_DATA após uma série de mensagens MIM_MOREDATA, ele é apanhado com eventos MIDI de entrada e pode chamar com segurança funções com uso intensivo de tempo.

As mensagens MIDI recebidas de uma porta de entrada MIDI estão em execução status desabilitadas; cada mensagem é expandida para incluir o byte de status MIDI.

Esta mensagem não é enviada quando uma mensagem exclusiva do sistema MIDI é recebida.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Mmsystem.h (incluir Windows.h)

Confira também

MIDI (Interface Digital de Instrumento Musical)

Mensagens MIDI