Compartilhar via


MM_MIM_MOREDATA mensagem

A mensagem MM_MIM_MOREDATA é enviada para uma janela de retorno de chamada 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 janela recebe essa mensagem somente quando o aplicativo especifica MIDI_IO_STATUS na chamada para a função midiInOpen .

MM_MIM_MOREDATA 
wParam = (WPARAM) hInput 
lParam = (LPARAM) (DWORD) lMidiMessage 

Parâmetros

hInput

Manipule para o dispositivo de entrada MIDI que recebeu a mensagem MIDI.

lMidiMessage

Especifica a mensagem MIDI que foi recebida. A mensagem é empacotada em um valor de palavra dupla da 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 midi status.

Valor Retornado

Esta mensagem não retorna um valor.

Comentários

Se o aplicativo receber dados MIDI mais rapidamente do que ele pode processá-los, você não deverá usar um mecanismo de retorno de chamada de janela. Para maximizar a velocidade, use uma função de retorno de chamada e use a mensagem MIM_MOREDATA em vez de MM_MIM_MOREDATA.

Um aplicativo deve fazer apenas uma quantidade mínima de processamento de mensagens MM_MIM_MOREDATA. (Em particular, os aplicativos não devem chamar a função PostMessage durante o processamento MM_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 MM_MIM_DATA após uma série de mensagens MM_MIM_MOREDATA, ele é pego com eventos MIDI de entrada e pode chamar funções com uso intensivo de tempo com segurança.

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

Essa mensagem não é enviada quando uma mensagem exclusiva do sistema MIDI é recebida. Nenhum carimbo de data/hora está disponível com esta mensagem. Para dados de entrada com carimbo de data/hora, você deve usar as mensagens enviadas para funções de retorno de chamada.

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 (inclua Windows.h)

Confira também

MIDI (Interface Digital do Instrumento Musical)

Mensagens MIDI