다음을 통해 공유


IRenderEngine::GetGroupOutputPin 메서드

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

참고

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

 

메서드는 GetGroupOutputPin 지정된 그룹에 대한 출력 핀을 검색합니다.

구문

HRESULT GetGroupOutputPin(
        long Group,
  [out] IPin **ppRenderPin
);

매개 변수

그룹

그룹을 지정하는 인덱스(0부터 시작)입니다.

ppRenderPin [out]

출력 핀의 IPin 인터페이스에 대한 포인터를 받습니다.

반환 값

HRESULT 값을 반환합니다. 가능한 값은 다음과 같습니다.

반환 코드 설명
S_FALSE
그룹에 출력 핀이 없습니다.
S_OK
성공.
E_INVALIDARG
인수가 잘못되었습니다.
E_MUST_INIT_RENDERER
렌더링 엔진을 초기화하지 못했습니다.
E_POINTER
잘못된 포인터입니다.
E_RENDER_ENGINE_IS_BROKEN
프로젝트가 성공적으로 렌더링되지 않아 작업이 실패했습니다.
E_UNEXPECTED
예기치 않은 오류입니다.

 

설명

이 메서드를 호출하기 전에 IRenderEngine::ConnectFrontEnd 를 호출하여 그래프의 프런트 엔드를 빌드합니다. 각 그룹은 단일 미디어 스트림을 나타내며 프런트 엔드에는 해당 출력 핀이 있습니다.

이 메서드를 사용하여 파일 쓰기 그래프의 렌더링 부분을 만들 수 있습니다. 출력 핀을 멀티플렉서 필터 및 파일 기록기 필터에 연결합니다. 자세한 내용은 프로젝트 렌더링을 참조하세요.

미리 보기의 경우 이 메서드를 호출할 필요가 없습니다. ConnectFrontEndIRenderEngine::RenderOutputPins를 호출하기만 하면 됩니다.

메서드가 S_OK 반환하는 경우 반환하는 IPin 인터페이스에는 미해결 참조 수가 있습니다. 사용이 완료되면 인터페이스를 해제해야 합니다.

참고

헤더 파일 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 인터페이스

오류 및 성공 코드