DirectShow DirectShow 레퍼런스 인터페이스 IDvdGraphBuilder GetDvdInterface   [목차열람] [주소복사] [슬롯비우기]

IDvdGraphBuilder::GetDvdInterface

GetDvdInterface 메서드는, DVD-Video 재생 그래프내의 특정의 인터페이스 포인터를 얻어온다. 이것에 의해, DVD-Video 재생의 개발이 간략화된다.

구문

HRESULT GetDvdInterface(
  REFIID riid,
  void **ppvIF
);

파라미터

riid

[in] 목적의 인터페이스의 IID.

ppvIF

[out] 취득된 인터페이스의 포인터 주소.

반환값

인터페이스의 처리에 응한 HRESULT 를 돌려준다.

DirectShow 의 처리의 반환값에는, 다음의 값이 포함된다.

주의

이 메서드를 사용해,IDvdControl2 인터페이스와 IDvdInfo2 인터페이스를 취득해 DVD-Video 볼륨의 재생을 제어하거나IAMLine21Decoder 인터페이스를 취득해 자막 방송 표시의 온과 오프를 바꾸는 것. 이 메서드를 사용해,IBasicVideo ,IVideoWindow ,IBasicAudio 의 각 인터페이스도 취득할 수 있다. 오디오 렌더러가 오디오를 렌더링 하는 경우만,IBasicAudio 의 포인터가 필요하다.

돌려받는 인터페이스 포인터에 미처리의 참조 카운트가 남는다. 호출원래는 그 인터페이스를 반드시 릴리즈 하는 것.

이 인터페이스를 사용하면 DVD-Video 재생 그래프내의오버레이 믹서 필터의 선두의 입력 핀 (1차 비디오 스트림)으로부터,IMixerPinConfig2 인터페이스를 취득할 수 있다. DVD-Video 그래프내의 오버레이 믹서로부터,IDDrawExclModeVideo 인터페이스도 취득할 수 있다. 이 인터페이스는, 게임에 따라서는, DirectDraw 의 배타 모드로 비디오를 재생할 경우에 필요하다. 다른 인터페이스와는 달라,IDvdGraphBuilder::GetDvdInterface 를 호출하기 전에,IDvdGraphBuilder::RenderDvdVideoVolume 메서드를 사용해 그래프를 생성 할 필요는 없다. 이 인터페이스를 사용하면 DVD-Video 재생 그래프내의오버레이 믹서 필터의 선두의 입력 핀 (1차 비디오 스트림)으로부터,IMixerPinConfig2 인터페이스를 취득할 수 있다. DVD-Video 그래프내의 오버레이 믹서로부터,IDDrawExclModeVideo 인터페이스도 취득할 수 있다. 이 인터페이스는, 게임에 따라서는, DirectDraw 의 배타 모드로 비디오를 재생할 경우에 필요하다. 다른 인터페이스와는 달라,IDvdGraphBuilder::GetDvdInterface 를 호출하기 전에,IDvdGraphBuilder::RenderDvdVideoVolume 메서드를 사용해 그래프를 생성 할 필요는 없다. -{}-이 인터페이스는,IDvdGraphBuilder::RenderDvdVideoVolume 메서드를 사용해 그래프를 생성 하기 전에 얻어올 필요가 있다.

이 인터페이스는,IDvdGraphBuilder::RenderDvdVideoVolume 메서드를 사용해 그래프를 생성 하기 전에 얻어올 필요가 있다.

참조

• 에러 코드와 성공 코드
• IDvdGraphBuilder 인터페이스