DirectMusic DirectMusic C/C++ 레퍼런스 DirectMusic 의 인터페이스 IDirectMusicPort8 SetReadNotificationHandle   [목차열람] [주소복사] [슬롯비우기]

IDirectMusicPort8::SetReadNotificationHandle

IDirectMusicPort8::Read 메서드를 사용해 MIDI 메시지를 읽어들일 수 있게 된 시점에서 설정하는 이벤트를 지정한다. 새로운 데이터가 이용 가능하게 되면 반드시 이벤트가 통지된다. 이벤트 통지를 무효로 하려면 ,hEvent 파라미터에 NULL 를 지정해 SetReadNotificationHandle 를 호출한다.

구문

HRESULT SetReadNotificationHandle(
  HANDLE hEvent
);

파라미터

hEvent

Win32 의 CreateEvent 함수를 호출해 취득한 이벤트 핸들. 애플리케이션은, 포트를 릴리즈 한 다음에 이 핸들을 닫지 않으면 안 된다.

반환값

성공했을 경우는 S_OK 를 돌려준다.

실패했을 경우는, 다음 표에 나타내는 에러값의 어느쪽이든을 돌려준다.

주의

반환값 E_NOTIMPL 는, 그 포트가 입력 포트가 아닌 것을 의미하는 경우도 있다.

요건

  헤더:dmusicc.h 로 선언.

참조

• MIDI 의 캡춰
• IDirectMusicPort8 인터페이스