midiStreamOpen

midiStreamOpen

MIDI 스트림을 출력용으로 오픈합니다.디폴트에서는 일시정지 모드로 오픈됩니다.

MMRESULT midiStreamOpen(
    LPHMIDISTRM phStream,   // 핸들을 격납하는 변수
    PUINT       puDeviceID, // 디바이스ID(을)를 격납한 변수
    DWORD       cMidi,      // 예약(1(을)를 지정)
    DWORD_PTR   dwCallback, // 콜백 파라미터
    DWORD_PTR   dwInstance, // 콜백에게 건네지는 데이터
    DWORD       fdwOpen     // 콜백 플래그
);

WINMM.DLL

인수

lphStream

MIDI 스트림의 핸들을 격납하기 위한 변수의 주소를 지정합니다.

puDeviceID

디바이스 ID (을)를 격납한 변수의 주소를 지정합니다.

cMidi

예약되고 있습니다. 1 (을)를 지정하지 않으면 안됩니다.

dwCallback

콜백 함수의 주소, 이벤트 핸들, 스렛드 ID , 윈도우 핸들, 또는, 스렛드한돌의 어느쪽이든을 지정합니다. MIDI 재생동안, 재생 경과에 관련되는 메세지를 처리하기 위해서, 이러한 어느쪽이든으로 콜백 처리를 행합니다.콜백을 사용하지 않는 경우는 0 (NULL) (을)를 지정합니다.

dwInstance

각각의 콜백 처리에게 건네지는 어플리케이션 고유의 인스턴스 데이터를 지정합니다.이 파라미터는, 윈도우 콜백 또는 스렛드에서는 사용되지 않습니다.

fdwOpen

디바이스를 오픈할 때의 콜백 플래그를 지정합니다.이하의 값의 어느쪽이든을 지정합니다.

치	의미
0x00000000 (CALLBACK_NULL)	콜백을 사용하지 않습니다.
0x00010000 (CALLBACK_WINDOW)	dwCallback 파라미터가 윈도우 핸들인 것을 지정합니다.
0x00020000 (CALLBACK_THREAD)	dwCallback 파라미터가 스렛드 ID 인 것을 지정합니다.
0x00030000 (CALLBACK_FUNCTION)	dwCallback 파라미터가 콜백 함수의 주소인 것을 지정합니다.
0x00050000 (CALLBACK_EVENT)	dwCallback 파라미터가 이벤트 핸들인 것을 지정합니다.

반환값

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

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

치	의미
2 (MMSYSERR_BADDEVICEID)	지정된 디바이스 ID (은)는 범위외입니다.
7 (MMSYSERR_NOMEM)	메모리의 확보 또는 락에 실패했습니다.
11 (MMSYSERR_INVALPARAM)	지정된 핸들 또는 플래그의 파라미터는 무효입니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후