다음을 통해 공유

IDvdGraphBuilder::GetDvdInterface 메서드(strmif.h)

  • 아티클

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

GetDvdInterface 메서드는 DVD-Video 재생 그래프에서 인터페이스를 검색하여 DVD-Video 재생 개발을 더 쉽게 만듭니다.

구문

HRESULT GetDvdInterface(
  [in]  REFIID riid,
  [out] void   **ppvIF
);

매개 변수

[in] riid

요청된 인터페이스의 IID입니다.

[out] ppvIF

인터페이스에 대한 포인터를 받습니다. 애플리케이션은 인터페이스를 해제해야 합니다.

반환 값

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

반환 코드 설명
E_INVALIDARG
 ppvIF 매개 변수가 잘못되었습니다. 이 매개 변수는 NULL이 아니어야 합니다.
E_NOINTERFACE
 요청된 인터페이스를 반환할 수 없습니다.
VFW_E_DVD_GRAPHNOTREADY
 그래프는 아직 빌드되지 않았습니다. 설명 부분을 참조하세요.

설명

DVD 재생을 위한 필터 그래프를 빌드하기 전에 이 메서드를 사용하여 비디오 렌더러 필터를 선택하고 구성할 수 있습니다. 다음 인터페이스를 사용할 수 있습니다.

필터 그래프를 빌드하기 전에 GetDvdInterface 를 호출하여 이러한 인터페이스를 가져오는 경우 DVD Graph Builder는 적절한 비디오 렌더러를 만듭니다. 나중에 그래프를 빌드할 때 이 렌더러를 사용합니다. 비디오 렌더러를 선택한 후에는 더 이상 다른 비디오 렌더러에 대한 인터페이스를 검색할 수 없습니다. GetDvdInterface 메서드는 E_NOINTERFACE 반환합니다.

DVD 재생 그래프를 빌드하기 전에 이전 목록에 없는 인터페이스를 요청하면 메서드가 VFW_E_DVD_GRAPHNOTREADY 반환합니다. DVD 그래프를 빌드하려면 IDvdGraphBuilder::RenderDvdVideoVolume을 호출합니다. 그래프를 빌드한 후 GetDvdInterface 를 사용하여 몇 가지 추가 인터페이스를 검색할 수 있습니다.

  • DVD 재생을 제어하는 IDvdControl(사용되지 않음), IDvdControl2, IDvdInfo(사용되지 않음) 및 IDvdInfo2.
  • IVideoWindow, IBasicVideo 및 IBasicVideo2 - 창 모드에서만 비디오 설정을 제어합니다.
  • 오디오 설정을 제어하는 IBasicAudio입니다.
  • 닫힌 캡션 디스플레이를 제어하는 IAMLine21Decoder입니다.
  • IMixerPinConfig 및 IMixerPinConfig2 는 기본 비디오 스트림을 제공하는 오버레이 믹서 필터의 첫 번째 입력 핀을 구성합니다. (오버레이 믹서의 다른 핀에 대해 이 인터페이스를 얻으려면 필터의 핀을 열거하고 직접 쿼리합니다.) 새 애플리케이션은 오버레이 믹서 필터를 사용하지 않아야 합니다.
다른 인터페이스를 얻으려면 IDvdGraphBuilder::GetFiltergraph를 호출합니다. 반환된 IGraphBuilder 인터페이스를 쿼리하거나 EnumFilters를 사용하여 필터를 열거합니다.

요구 사항

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

추가 정보

DVD 응용 프로그램

오류 및 성공 코드

IDvdGraphBuilder 인터페이스