midiInStart 함수(mmeapi.h)

  • 아티클

midiInStart 함수는 지정된 MIDI 입력 디바이스에서 MIDI 입력을 시작합니다.

구문

MMRESULT midiInStart(
  HMIDIIN hmi
);

매개 변수

hmi

MIDI 입력 디바이스에 대한 핸들입니다.

반환 값

성공하거나 오류가 있으면 MMSYSERR_NOERROR 반환합니다. 가능한 오류 값에는 다음이 포함됩니다.

반환 코드 설명
MMSYSERR_INVALHANDLE
 지정된 디바이스 핸들이 잘못되었습니다.

설명

이 함수는 타임스탬프를 0으로 다시 설정합니다. 이후에 받은 메시지에 대한 타임스탬프는 이 함수가 호출된 시간을 기준으로 합니다.

시스템 전용 메시지를 제외한 모든 메시지는 수신될 때 클라이언트로 직접 전송됩니다. 시스템 전용 메시지는 midiInAddBuffer 함수에서 제공하는 버퍼에 배치됩니다. 큐에 버퍼가 없으면 클라이언트에 대한 알림 없이 시스템 전용 데이터가 버려지고 입력이 계속됩니다. 버퍼는 가득 차거나, 전체 시스템 전용 메시지를 수신하거나, midiInReset 함수를 사용할 때 클라이언트에 반환됩니다. MIDIHDR 구조체의 dwBytesRecorded 멤버에는 수신된 데이터의 실제 길이가 포함됩니다.

입력이 이미 시작되었을 때 이 함수를 호출해도 아무런 효과가 없으며 함수는 0을 반환합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 mmeapi.h(Windows.h 포함)
라이브러리 Winmm.lib
DLL Winmm.dll

참고 항목

MIDI 함수