IMFPMediaItem::SetStreamSink 메서드(mfplay.h)

  • 아티클
중요 되지 않는. 이 API는 향후 Windows 릴리스에서 제거될 수 있습니다. 애플리케이션은 재생에 미디어 세션을 사용해야 합니다.
 

미디어 항목에 대한 미디어 싱크를 설정합니다. 미디어 싱크는 하나 이상의 스트림에서 데이터를 사용하는 개체입니다.

구문

HRESULT SetStreamSink(
  [in] DWORD    dwStreamIndex,
  [in] IUnknown *pMediaSink
);

매개 변수

[in] dwStreamIndex

미디어 원본에 있는 스트림의 인덱스(0부터 시작)입니다. 미디어 싱크는 이 스트림에서 데이터를 받습니다.

[in] pMediaSink

미디어 싱크를 지정하는 IUnknown 포인터입니다. 다음 중 하나를 전달합니다.

  • 스트림 싱크에 대한 포인터입니다. 모든 미디어 싱크에는 하나 이상의 스트림 싱크가 포함됩니다. 각 스트림 싱크는 하나의 스트림에서 데이터를 수신합니다. 스트림 싱크는 IMFStreamSink 인터페이스를 노출해야 합니다.
  • 미디어 싱크를 만드는 활성화 개체에 대한 포인터입니다. 활성화 개체는 IMFActivate 인터페이스를 노출해야 합니다. 미디어 항목은 미디어 싱크의 첫 번째 스트림 싱크(즉, 인덱스 0의 스트림 싱크)를 사용합니다.
  • NULL. pMediaSink를 NULL로 설정하면 스트림 유형에 대한 기본 미디어 싱크가 사용됩니다.

반환 값

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

기본적으로 MFPlay 플레이어 개체는 오디오 스트림을 SAR( 스트리밍 오디오 렌더러 )로 렌더링하고 비디오 스트림을 EVR( 고급 비디오 렌더러 )로 렌더링합니다. SetStreamSink 메서드를 사용하여 오디오 또는 비디오 스트림에 다른 미디어 싱크를 제공할 수 있습니다. 또는 오디오 및 비디오 외에 다른 스트림 유형을 지원합니다. SAR 또는 EVR을 사용하기 전에 구성하는 데 사용할 수도 있습니다.

IMFPMediaPlayer::SetMediaItem을 호출하기 전에 이 메서드를 호출합니다. 재생을 중지하고 SetMediaItem 을 다시 호출하지 않는 한 SetMediaItem 이후에 이 메서드를 호출해도 아무 효과가 없습니다.

기본 미디어 싱크를 사용하도록 미디어 항목을 다시 설정하려면 pMediaSink 를 NULL로 설정합니다.

원격 재생 최적화

애플리케이션이 원격 데스크톱을 통해 실행 중이고 오디오 또는 비디오 스트림에 대해 NULL이 아닌 값으로 이 메서드를 호출하는 경우 MFPlay는 원격 재생 최적화를 사용하지 않도록 설정합니다. 이 설명은 오디오 및 비디오 스트림에만 적용됩니다. 텍스트와 같은 다른 데이터 형식을 포함하는 스트림에는 적용되지 않습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 mfplay.h

추가 정보

IMFPMediaItem

미디어 싱크

오디오/비디오 재생에 MFPlay 사용