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 |
|---|---|
|
O dispositivo de entrada especificado já está conectado a um dispositivo de saída. |
|
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 |