영어로 읽기

다음을 통해 공유

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 반환하고, 그렇지 않으면 오류를 반환합니다. 가능한 오류 값은 다음과 같습니다.

반환 코드 설명
MIDIERR_NOTREADY
 지정된 입력 디바이스가 출력 디바이스에 이미 연결되어 있습니다.
MMSYSERR_INVALHANDLE
 지정된 디바이스 핸들이 잘못되었습니다.

설명

이 함수를 호출한 후 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

참고 항목

MIDI 함수