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 |
|---|---|
|
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 |