IGraphBuilder 인터페이스(strmif.h)

[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 DirectShow 대신 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

이 인터페이스는 애플리케이션이 필터 그래프를 빌드할 수 있도록 하는 메서드를 제공합니다. Filter Graph Manager는 이 인터페이스를 구현합니다.

IGraphBuilder 인터페이스는 IFilterGraph 인터페이스에서 상속됩니다. IFilterGraph 는 그래프에 필터를 추가하거나 두 개의 핀을 연결하는 것과 같은 기본 작업을 제공합니다. IGraphBuilder는 부분 정보에서 그래프를 생성하는 추가 메서드를 추가합니다. 예를 들어 IGraphBuilder::RenderFile 메서드는 파일 이름을 지정하여 파일 재생을 위한 그래프를 빌드합니다. IGraphBuilder::Render 메서드는 새 필터를 핀에 연결하여 출력 핀에서 데이터를 렌더링합니다.

이러한 메서드를 사용하면 애플리케이션에서 그래프의 모든 필터 및 핀 연결을 지정할 필요가 없습니다. 대신 필터 그래프 관리자는 사용자 시스템에 등록된 필터를 선택하고 그래프에 추가하고 연결합니다. 자세한 내용은 Intelligent Connect를 참조하세요.

상속

IGraphBuilder 인터페이스는 IFilterGraph에서 상속됩니다. IGraphBuilder 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IGraphBuilder 인터페이스에는 이러한 메서드가 있습니다.

IGraphBuilder::Abort Abort 메서드는 필터 그래프 관리자에게 현재 작업을 가능한 한 빨리 중지하도록 요청합니다.
IGraphBuilder::AddSourceFilter AddSourceFilter 메서드는 지정된 파일의 원본 필터를 필터 그래프에 추가합니다.
IGraphBuilder::Connect Connect 메서드는 필요한 경우 중간을 사용하여 두 핀을 연결합니다.
IGraphBuilder::Render Render 메서드는 지정된 출력 핀에서 데이터를 렌더링하는 필터 그래프를 작성합니다.
IGraphBuilder::RenderFile RenderFile 메서드는 지정된 파일을 렌더링하는 필터 그래프를 작성합니다. (IGraphBuilder.RenderFile)
IGraphBuilder::SetLogFile SetLogFile 메서드는 작업을 수행하려고 할 때 수행되는 로깅 작업에 대한 파일을 설정합니다.
IGraphBuilder::ShouldOperationContinue ShouldOperationContinue 메서드는 현재 작업을 계속할지 여부를 쿼리합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	strmif.h(Dshow.h 포함)

추가 정보

IFilterGraph

인터페이스