midiInOpen 함수(mmeapi.h)

midiInOpen 함수는 지정된 MIDI 입력 디바이스를 엽니다.

구문

MMRESULT midiInOpen(
  LPHMIDIIN phmi,
  UINT      uDeviceID,
  DWORD_PTR dwCallback,
  DWORD_PTR dwInstance,
  DWORD     fdwOpen
);

phmi

HMIDIIN 핸들에 대한 포인터입니다. 이 위치는 열린 MIDI 입력 디바이스를 식별하는 핸들로 채워집니다. 핸들은 다른 MIDI 입력 함수 호출에서 디바이스를 식별하는 데 사용됩니다.

uDeviceID

열 MIDI 입력 디바이스의 식별자입니다.

dwCallback

들어오는 MIDI 메시지에 대한 정보를 사용하여 호출된 창의 콜백 함수, 스레드 식별자 또는 핸들에 대한 포인터입니다. 콜백 함수에 대한 자세한 내용은 MidiInProc을 참조하세요.

dwInstance

콜백 함수에 전달된 사용자 instance 데이터입니다. 이 매개 변수는 창 콜백 함수 또는 스레드와 함께 사용되지 않습니다.

fdwOpen

디바이스를 열기 위한 콜백 플래그 및 필요에 따라 신속한 데이터 전송을 규제하는 데 도움이 되는 상태 플래그입니다. 다음 값일 수 있습니다.

값	의미
CALLBACK_FUNCTION	dwCallback 매개 변수는 콜백 프로시저 주소입니다.
CALLBACK_NULL	콜백 메커니즘이 없습니다. 이 값은 기본 설정입니다.
CALLBACK_THREAD	dwCallback 매개 변수는 스레드 식별자입니다.
CALLBACK_WINDOW	dwCallback 매개 변수는 창 핸들입니다.
MIDI_IO_STATUS	이 매개 변수가 CALLBACK_FUNCTION 지정하면 MIM_MOREDATA 메시지가 콜백 함수와 MIM_DATA 메시지로 전송됩니다. 또는 이 매개 변수가 CALLBACK_WINDOW 지정하는 경우 MM_MIM_MOREDATA 메시지가 창과 MM_MIM_DATA 메시지로 전송됩니다. 이 플래그는 이벤트 또는 스레드 콜백에 영향을 주지 않습니다.

콜백 메커니즘을 사용하는 대부분의 애플리케이션은 이 매개 변수에 대한 CALLBACK_FUNCTION 지정합니다.

성공하면 MMSYSERR_NOERROR 반환하고, 그렇지 않으면 오류를 반환합니다. 가능한 오류 값에는 다음이 포함됩니다.

시스템에 있는 MIDI 입력 디바이스 수를 확인하려면 midiInGetNumDevs 함수를 사용합니다. wDeviceID로 지정된 디바이스 식별자는 존재하는 디바이스 수보다 0개에서 1개까지 다양합니다.

콜백 정보를 수신하도록 창 또는 스레드를 선택한 경우 다음 메시지가 창 프로시저 또는 스레드로 전송되어 MIDI 입력의 진행률을 나타냅니다. MM_MIM_OPEN, MM_MIM_CLOSE, MM_MIM_DATA, MM_MIM_LONGDATA, MM_MIM_ERROR, MM_MIM_LONGERROR 및 MM_MIM_MOREDATA.

함수가 콜백 정보를 수신하도록 선택된 경우 MIDI 입력의 진행률을 나타내기 위해 함수로 전송됩니다. MIM_OPEN, MIM_CLOSE, MIM_DATA, MIM_LONGDATA, MIM_ERROR, MIM_LONGERROR 및 MIM_MOREDATA.

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