IRenderEngine::SetFilterGraph 메서드

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

참고

[더 이상 사용되지 않습니다. 이 API는 향후 Windows 릴리스에서 제거될 수 있습니다.]

 

메서드는 SetFilterGraph 렌더링 엔진에서 사용할 필터 그래프를 지정합니다.

구문

HRESULT SetFilterGraph(
   IGraphBuilder *pFG
);

매개 변수

pFG

필터 그래프의 IGraphBuilder 인터페이스에 대한 포인터입니다.

반환 값

다음 HRESULT 값 중 하나를 반환합니다.

반환 코드 Description
S_OK
성공.
E_INVALIDARG
인수가 잘못되었습니다.
E_MUST_INIT_RENDERER
렌더링 엔진을 초기화하지 못했습니다.

 

설명

대부분의 애플리케이션은 이 메서드를 호출할 필요가 없습니다. IRenderEngine::ConnectFrontEnd 메서드를 호출하여 렌더링 엔진이 그래프를 빌드하도록 하는 것이 더 일반적입니다.

렌더링 엔진에 필터 그래프가 이미 있는 경우 이 메서드가 실패합니다.

한 렌더링 엔진에서 만든 필터 그래프에 대한 포인터를 검색하지 않은 다음 다른 렌더링 엔진에서 이 메서드에 대한 매개 변수로 사용하지 마세요. 이렇게 하면 예측할 수 없는 결과가 발생합니다.

ConnectFrontEnd 메서드는 기존 필터 그래프를 중단하지만 동일한 Filter Graph Manager instance 유지합니다.

참고

헤더 파일 Qedit.h는 버전 7 이후의 Direct3D 헤더와 호환되지 않습니다.

 

참고

Qedit.h를 가져오려면 Windows Vista용 Microsoft Windows SDK 업데이트를 다운로드하고 3.0을 .NET Framework. Qedit.h는 Windows 7 및 .NET Framework 3.5 서비스 팩 1용 Microsoft Windows SDK 사용할 수 없습니다.

 

요구 사항

요구 사항
헤더
Qedit.h
라이브러리
Strmiids.lib

추가 정보

IRenderEngine 인터페이스

오류 및 성공 코드