midiConnect 함수(mmeapi.h)
midiConnect 함수는 MIDI 입력 디바이스를 MIDI 스루 또는 출력 디바이스에 연결하거나 MIDI를 통해 디바이스를 MIDI 출력 디바이스에 연결합니다.
구문
MMRESULT midiConnect(
HMIDI hmi,
HMIDIOUT hmo,
LPVOID pReserved
);
매개 변수
hmi
MIDI 입력 디바이스 또는 MIDI를 통해 디바이스에 대한 핸들입니다. (디바이스를 통해 이 핸들은 midiOutOpen 함수를 호출하여 반환되어야 합니다.)
hmo
MIDI 출력 또는 디바이스를 통해 처리합니다.
pReserved
예약; 은 NULL이어야 합니다.
반환 값
성공하면 MMSYSERR_NOERROR 반환하고, 그렇지 않으면 오류를 반환합니다. 가능한 오류 값은 다음과 같습니다.
반환 코드 | 설명 |
---|---|
|
지정된 입력 디바이스가 출력 디바이스에 이미 연결되어 있습니다. |
|
지정된 디바이스 핸들이 잘못되었습니다. |
설명
이 함수를 호출한 후 MIDI 입력 디바이스는 동일한 이벤트 데이터가 있는 메시지가 출력 디바이스 드라이버로 전송될 때마다 MIM_DATA 메시지에서 이벤트 데이터를 받습니다.
thru 드라이버는 특수한 형태의 MIDI 출력 드라이버입니다. 시스템은 MIDI 입력 디바이스에 하나의 MIDI 출력 디바이스만 연결할 수 있지만 여러 MIDI 출력 디바이스는 MIDI를 통해 디바이스에 연결할 수 있습니다. 지정된 MIDI 입력 디바이스가 MIM_DATA 메시지에서 이벤트 데이터를 받을 때마다 동일한 이벤트 데이터가 있는 메시지가 지정된 출력 디바이스 드라이버(또는 드라이버를 통해 출력 드라이버로)로 전송됩니다.
요구 사항
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | mmeapi.h(Windows.h 포함) |
라이브러리 | Winmm.lib |
DLL | Winmm.dll |