DirectShow DirectShow 레퍼런스 인터페이스 IMediaControl Stop   [목차열람] [주소복사] [슬롯비우기]

IMediaControl::Stop

Stop 메서드는, 그래프의 모든 필터를 정지한다.

구문

HRESULT Stop(void);

반환값

성공했을 경우는 S_OK 를 돌려준다. 그 이외의 경우는, 에러의 원인을 나타내는 HRESULT 값을 돌려준다.

주의

그래프가 실행중의 경우, 이 메서드는 그 그래프를 정지시키기 전에 포즈 시킨다. 포즈중은, 비디오 렌더러는 현재의 프레임을 포스터 프레임으로서 디스플레이에 복사 할 수 있다.

이 메서드는 스트림의 처음까지 시크 하지 않는다. 이 메서드를 호출해, 다음에 IMediaControl::Run 메서드를 호출하면, 정지 위치로부터 재생된다. 그래프를 시크 하려면 ,IMediaSeeking 인터페이스를 사용하는 것.

필터 그래프 매니저는 그래프내의 모든 필터로 포즈를 호출해, 다음에 포즈 조작의 완료를 기다리지 않고 모든 필터로 IMediaFilter::Stop 메서드를 호출한다. 따라서, 포즈 조작의 완료전에 Stop 메서드의 호출을 받는 필터가 있을지도 모른다. 커스텀 렌더링 필터를 개발하고 있는 경우는, 이러한 케이스를 고려해, 실행 상태에 아직 있는 동안에 정지 커멘드를 받으면 최초로 필터를 포즈 하도록(듯이) 해야 한다. 그러나, 대부분의 필터는 이러한 경우에 특히 무엇인가를 할 필요는 없다.

참조

• StopWhenReady
• 에러 코드와 성공 코드
• IMediaControl 인터페이스