Compartilhar via


Função midiConnect (mmeapi.h)

A função midiConnect conecta um dispositivo de entrada MIDI a um dispositivo MIDI por meio de saída ou midi ou conecta um dispositivo MIDI por meio de um dispositivo de saída MIDI.

Sintaxe

MMRESULT midiConnect(
  HMIDI    hmi,
  HMIDIOUT hmo,
  LPVOID   pReserved
);

Parâmetros

hmi

Manipule para um dispositivo de entrada MIDI ou MIDI por meio de um dispositivo. (Para dispositivos, esse identificador deve ter sido retornado por uma chamada para a função midiOutOpen .)

hmo

Manipule para a saída MIDI ou por meio do dispositivo.

pReserved

Reservados; deve ser NULL.

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
MIDIERR_NOTREADY
O dispositivo de entrada especificado já está conectado a um dispositivo de saída.
MMSYSERR_INVALHANDLE
O identificador de dispositivo especificado é inválido.

Comentários

Depois de chamar essa função, o dispositivo de entrada MIDI recebe dados de evento em uma mensagem MIM_DATA sempre que uma mensagem com os mesmos dados de evento é enviada para o driver de dispositivo de saída.

Um driver thru é uma forma especial de driver de saída MIDI. O sistema permitirá que apenas um dispositivo de saída MIDI seja conectado a um dispositivo de entrada MIDI, mas vários dispositivos de saída MIDI podem ser conectados a um dispositivo MIDI por meio de . Sempre que o dispositivo de entrada MIDI fornecido recebe dados de evento em uma mensagem MIM_DATA, uma mensagem com os mesmos dados de evento é enviada para o driver de dispositivo de saída fornecido (ou por meio do driver through para os drivers de saída).

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