midiOutReset

midiOutReset

지정되었다 MIDI 출력 디바이스의 모든 채널의 노트를 오프로 합니다.

MMRESULT midiOutReset(
    HMIDIOUT hmo   // MIDI출력 디바이스의 핸들
);

WINMM.DLL

인수

hmo

MIDI 출력 디바이스의 핸들을 지정합니다. MIDI 스트림의 핸들을 지정할 수도 있습니다.

반환값

함수가 성공하면 0 (MMSYSERR_NOERROR) 하지만 돌아갑니다.

함수가 실패하면, 이하의 에러가 돌아갑니다.

치	의미
5 (MMSYSERR_INVALHANDLE)	지정된 핸들은 무효입니다.

해설

미처리의 시스템에크스크루시브 및 스트림 출력 버퍼는 모두 콜백 함수에 돌려주어지고, MIDIHDR 구조체의 dwFlags 멤버에는 MHDR_DONE 플래그가 세트 됩니다.

EOX 아르바이트를 보내지 않고 시스템에크스크루시브멧세이지를 끝내면, 수신 디바이스에 문제를 일으킬 가능성이 있습니다.이 함수는, 시스템에크스크루시브멧세이지를 끝냈을 때에 EOX 아르바이트를 송신하지 않습니다.따라서, 어플리케이션 자신이 EOX 아르바이트를 송신하지 않으면 안됩니다.

이 함수는, 각 채널의 각각의 노트에 대해서 노트 오프 메세지를 송신하고, 모든 노트를 오프로 합니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후