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

IMediaFilter::Run

Run 메서드는, 필터를 실행한다.

구문

HRESULT Run(
  REFERENCE_TIME tStart
);

파라미터

tStart

스트림 타임 0 에 대응하는 기준 타임.

반환값

HRESULT 값을 돌려준다. 가능한 값은 다음의 일람대로이다.

주의

필터가 실행중 때, 필터는 샘플을 받아, 처리해, 출력할 수 있다. 소스 필터는 새로운 샘플을 생성해, 렌더링 필터는 그러한 샘플을 렌더링 한다.

상태 처리은 비동기의 경우가 있다. 처리이 완료하기 전에 메서드가 돌아가는 경우, 반환값은 S_FALSE 가 된다.

스트림 타임은 현재의 기준 타임부터 tStart 를 빼 계산된다. 미디어 샘플이 언제 렌더링 되는지를 계산하기 위해서, 렌더러는 현재의 스트림 타임과 타임 스탬프를 비교한다. 그 때문에, 타임 스탬프가 제로의 미디어 샘플은,tStart 시에 렌더링 될 필요가 있다. 더 자세한 정보는, 「DirectShow 의 타임과 클럭」을 참조할것.

애플리케이션이 IMediaControl::Run 메서드를 호출하는 경우에, 필터 그래프 매니저는 각 필터로 IMediaFilter::Run 를 호출한다. 필터 그래프 매니저는 tStart 의 값을 조금 다음에 설정해, 그래프의 지연 시간에 대응한다.

참조

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