다음을 통해 공유

midiOutLongMsg 함수(mmeapi.h)

  • 아티클

midiOutLongMsg 함수는 지정된 MIDI 출력 디바이스에 시스템 전용 MIDI 메시지를 보냅니다.

구문

MMRESULT midiOutLongMsg(
  HMIDIOUT  hmo,
  LPMIDIHDR pmh,
  UINT      cbmh
);

매개 변수

hmo

MIDI 출력 디바이스에 대한 핸들입니다. 이 매개 변수는 HMIDIOUT으로 캐스팅된 MIDI 스트림의 핸들일 수도 있습니다.

pmh

MIDI 버퍼를 식별하는 MIDIHDR 구조체에 대한 포인터입니다.

cbmh

MIDIHDR 구조체의 크기(바이트)입니다.

반환 값

성공하면 MMSYSERR_NOERROR 반환하고, 그렇지 않으면 오류를 반환합니다. 가능한 오류 값은 다음과 같습니다.

반환 코드 설명
MIDIERR_NOTREADY
 하드웨어가 다른 데이터로 사용 중입니다.
MIDIERR_UNPREPARED
 lpMidiOutHdr에서 가리키는 버퍼가 준비되지 않았습니다.
MMSYSERR_INVALHANDLE
 지정한 디바이스 핸들이 잘못되었습니다.
MMSYSERR_INVALPARAM
 지정한 포인터 또는 구조체가 잘못되었습니다.

설명

버퍼가 midiOutLongMsg에 전달되기 전에 midiOutPrepareHeader 함수를 사용하여 준비해야 합니다. MIDI 출력 디바이스 드라이버는 데이터가 동기적으로 또는 비동기적으로 전송되는지 여부를 결정합니다.

요구 사항

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

참고 항목

MIDI 함수