IMediaEvent 인터페이스(control.h)
[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드가 DirectShow 대신 Media Foundation에서 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]
인터페이스에는 IMediaEvent 이벤트 알림을 검색하고 Filter Graph Manager의 이벤트 기본 처리를 재정의하는 메서드가 포함되어 있습니다. IMediaEventEx 인터페이스는 이 인터페이스를 상속하고 확장합니다.
Filter Graph Manager는 이 인터페이스를 구현합니다. 애플리케이션은 스트림의 끝 또는 렌더링 오류와 같이 필터 그래프에서 발생하는 이벤트에 응답하는 데 사용할 수 있습니다. IMediaEventSink 인터페이스를 사용하여 이벤트 게시를 필터 그래프로 필터링합니다.
이벤트 알림에 대한 자세한 내용은 DirectShow의 이벤트 알림을 참조하세요. 시스템 정의 이벤트 알림 목록은 이벤트 알림 코드를 참조하세요.
상속
IMediaEvent 인터페이스는 IDispatch 인터페이스에서 상속됩니다. IMediaEvent 에는 다음과 같은 유형의 멤버도 있습니다.
메서드
IMediaEvent 인터페이스에는 이러한 메서드가 있습니다.
| IMediaEvent::CancelDefaultHandling CancelDefaultHandling 메서드는 지정된 이벤트에 대한 Filter Graph Manager의 기본 처리를 취소합니다. 이벤트 알림이 애플리케이션에 전달됩니다. |
| IMediaEvent::FreeEventParams FreeEventParams 메서드는 이벤트의 매개 변수와 연결된 리소스를 해제합니다. |
| IMediaEvent::GetEvent GetEvent 메서드는 이벤트 큐에서 다음 이벤트 알림을 검색합니다. |
| IMediaEvent::GetEventHandle GetEventHandle 메서드는 큐에 이벤트 알림이 포함된 동안 신호가 유지되는 수동 재설정 이벤트에 대한 핸들을 검색합니다. |
| IMediaEvent::RestoreDefaultHandling RestoreDefaultHandling 메서드는 지정된 이벤트에 대한 Filter Graph Manager의 기본 처리를 복원합니다. |
| IMediaEvent::WaitForCompletion WaitForCompletion 메서드는 필터 그래프가 사용 가능한 모든 데이터를 렌더링할 때까지 기다립니다. 필터 그래프가 실행 중이거나 메서드가 실패해야 합니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | control.h(Dshow.h 포함) |