Função midiInStart (mmeapi.h)

A função midiInStart inicia a entrada MIDI no dispositivo de entrada MIDI especificado.

Sintaxe

MMRESULT midiInStart(
  HMIDIIN hmi
);

Parâmetros

hmi

Manipule para o dispositivo de entrada MIDI.

Valor retornado

Retorna MMSYSERR_NOERROR se tiver êxito ou um erro de outra forma. Os valores de erro possíveis incluem o seguinte

Código de retorno	Descrição
MMSYSERR_INVALHANDLE	O identificador de dispositivo especificado é inválido.

Comentários

Essa função redefine o carimbo de data/hora como zero; Os valores de carimbo de data/hora para mensagens recebidas posteriormente são relativos ao tempo em que essa função foi chamada.

Todas as mensagens, exceto mensagens exclusivas do sistema, são enviadas diretamente ao cliente quando são recebidas. Mensagens exclusivas do sistema são colocadas nos buffers fornecidos pela função midiInAddBuffer . Se não houver buffers na fila, os dados exclusivos do sistema serão jogados fora sem notificação ao cliente e a entrada continuará. Os buffers são retornados ao cliente quando estão cheios, quando uma mensagem completa exclusiva do sistema é recebida ou quando a função midiInReset é usada. O membro dwBytesRecorded da estrutura MIDIHDR conterá o comprimento real dos dados recebidos.

Chamar essa função quando a entrada já está iniciada não tem efeito e a função retorna zero.

Requisitos

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]
Plataforma de Destino	Windows
Cabeçalho	mmeapi.h (inclua Windows.h)
Biblioteca	Winmm.lib
DLL	Winmm.dll

Confira também

Funções MIDI