DirectShow DirectShow 레퍼런스 인터페이스 IGraphBuilder [목차열람] [주소복사] [슬롯비우기] |
Microsoft DirectX 9.0 |
이 인터페이스는, 애플리케이션으로부터 필터 그래프를 생성 하는 메서드를 제공한다. 필터 그래프 매니저는, 이 인터페이스를 처리 하고 있다.
IGraphBuilder 는 IFilterGraph 인터페이스를 계승한다. IFilterGraph 가 제공하는 것은, 그래프에의 필터의 추가, 2 개의 핀의 접속등의 기본적인 조작이다. IGraphBuilder 는, 이것들에 가세해 부분적인 정보로부터 그래프를 생성 하는 메서드를 제공한다. 예를 들어,IGraphBuilder::RenderFile 메서드는, 지정된 파일명에 대응하는 파일 재생용의 그래프를 생성 한다. 또,IGraphBuilder::Render 메서드는, 출력 핀에 새로운 필터를 접속해, 그 핀으로부터의 데이터를 렌더링 한다.
이러한 메서드를 사용하면 그 그래프의 모든 필터와 핀 접속을, 애플리케이션으로부터 개별적으로 지정하는 수고를 생략할 수가 있다. 애플리케이션 대신에, 필터 그래프 매니저가, 사용자의 시스템에 등록되어 있는 필터로부터 선택한 필터를, 그래프에 추가해 접속한다. 더 자세한 정보는, 「인텔리전트 접속」을 참조할것.
IGraphBuilder 인터페이스는,IFilterGraph 로부터 계승하는 메서드 이외에 이하의 메서드도 공개한다.
메서드 | 설명 |
Connect | 2 개의 핀을 접속한다. 직접 접속할 수 없는 경우는 변환 필터를 개입시켜 접속한다. |
Render | 지정된 출력 핀에 필터 체인을 추가해 렌더링 한다. |
RenderFile | 지정된 파일을 렌더링 하는 필터 그래프를 생성 한다. |
AddSourceFilter | 특정의 파일에 대응하는 필터 그래프에 소스 필터를 추가한다. |
SetLogFile | 로그 파일을 설정한다. 이 파일에는 조작을 실행하려고 했을 때에 행해진 각 액션이 출력된다. |
Abort | 현재의 태스크로부터 생기는 한 빨리 돌아오도록(듯이) 그래프 빌더에 요구한다. |
ShouldOperationContinue | 현재의 조작을 계속해야할 것인가 제발을 조회한다. |