funzione midiConnect (mmeapi.h)

La funzione midiConnect connette un dispositivo di input MIDI a un dispositivo MIDI thru o output oppure connette un dispositivo MIDI thru a un dispositivo di output MIDI.

Sintassi

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

Parametri

hmi

Gestire un dispositivo di input MIDI o un dispositivo MIDI thru. Per i dispositivi thru, questo handle deve essere stato restituito da una chiamata alla funzione midiOutOpen .

hmo

Gestire l'output MIDI o il dispositivo thru.

pReserved

Riservati; deve essere NULL.

Valore restituito

Restituisce MMSYSERR_NOERROR se ha esito positivo o un errore in caso contrario. I valori di errore possibili includono quanto segue.

Codice restituito	Descrizione
MIDIERR_NOTREADY	Il dispositivo di input specificato è già connesso a un dispositivo di output.
MMSYSERR_INVALHANDLE	L'handle del dispositivo specificato non è valido.

Commenti

Dopo aver chiamato questa funzione, il dispositivo di input MIDI riceve i dati degli eventi in un messaggio MIM_DATA ogni volta che viene inviato un messaggio con gli stessi dati evento al driver del dispositivo di output.

Un driver thru è una forma speciale di driver di output MIDI. Il sistema consentirà la connessione di un solo dispositivo di output MIDI a un dispositivo di input MIDI, ma più dispositivi di output MIDI possono essere connessi a un dispositivo MIDI thru. Ogni volta che il dispositivo di input MIDI specificato riceve i dati degli eventi in un messaggio di MIM_DATA, viene inviato un messaggio con gli stessi dati dell'evento al driver del dispositivo di output specificato (o tramite il driver di output ai driver di output).

Requisiti

Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mmeapi.h (includere Windows.h)
Libreria	Winmm.lib
DLL	Winmm.dll

Vedi anche

Funzioni MIDI