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 반환하고, 그렇지 않으면 오류를 반환합니다. 가능한 오류 값은 다음과 같습니다.
| 반환 코드 | 설명 |
|---|---|
|
하드웨어가 다른 데이터로 사용 중입니다. |
|
lpMidiOutHdr에서 가리키는 버퍼가 준비되지 않았습니다. |
|
지정한 디바이스 핸들이 잘못되었습니다. |
|
지정한 포인터 또는 구조체가 잘못되었습니다. |
설명
버퍼가 midiOutLongMsg에 전달되기 전에 midiOutPrepareHeader 함수를 사용하여 준비해야 합니다. MIDI 출력 디바이스 드라이버는 데이터가 동기적으로 또는 비동기적으로 전송되는지 여부를 결정합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | mmeapi.h(Windows.h 포함) |
| 라이브러리 | Winmm.lib |
| DLL | Winmm.dll |