Share via

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

  • 아티클

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

메서드는 RenderDvdVideoVolume DVD-Video 볼륨을 재생하기 위한 사용자 사양에 따라 필터 그래프 빌드를 완료합니다.

구문

HRESULT RenderDvdVideoVolume(
  [in]  LPCWSTR             lpcwszPathName,
  [in]  DWORD               dwFlags,
  [out] AM_DVD_RENDERSTATUS *pStatus
);

매개 변수

[in] lpcwszPathName

재생할 DVD-Video 볼륨의 경로에 대한 포인터입니다. NULL일 수 있습니다.

[in] dwFlags

DVD 재생 그래프를 빌드하는 방법을 지정하는 AM_DVD_GRAPH_FLAGS 열거형의 플래그 비트 OR입니다.

[out] pStatus

AM_DVD_RENDERSTATUS 구조체에 대한 포인터입니다. 메서드가 반환되면 구조체는 렌더링 실패를 나타냅니다.

반환 값

인터페이스의 구현에 따라 달라지는 HRESULT 값을 반환합니다. DirectShow 구현 반환 값에는 다음이 포함됩니다.

반환 코드 설명
E_INVALIDARG
 dwFlags 매개 변수는 충돌하는 옵션을 지정합니다.
S_FALSE
 메서드가 부분적으로 성공했습니다. 발생한 오류를 확인하려면 pStatus 매개 변수를 검사합니다.
S_OK
 메서드가 성공했고 모든 스트림이 렌더링되었습니다.
VFW_E_DVD_DECNOTENOUGH
 하나 이상의 스트림을 렌더링할 수 없습니다.

dwFlags 매개 변수에서 AM_DVD_HWDEC_ONLY 또는 AM_DVD_SWDEC_ONLY 플래그를 지정한 경우 AM_DVD_HWDEC_PREFER 또는 AM_DVD_SWDEC_PREFER 플래그를 사용하여 메서드를 다시 호출해 보세요.
VFW_E_DVD_NON_EVR_RENDERER_IN_FILTER_GRAPH
 필터 그래프에는 이미 비디오 렌더러가 포함되어 있습니다. 메서드는 dwFlags 매개 변수에서 AM_DVD_EVR_ONLY 플래그를 지정하지만 그래프에 VMR(고급 비디오 렌더러) 필터 이외의 비디오 렌더러가 이미 포함되어 있는 경우 이 오류 코드를 반환합니다.
VFW_E_DVD_RENDERFAIL
 그래프를 작성하는 동안 오류가 발생했습니다. 예를 들어 DVD Graph Builder에서 필요한 필터를 만들 수 없거나 스트림을 렌더링할 수 없습니다.
VFW_E_DVD_TOO_MANY_RENDERERS_IN_FILTER_GRAPH
 필터 그래프에는 둘 이상의 비디오 렌더러가 포함되어 있습니다.

설명

AM_DVD_RENDERSTATUS 구조는 이 메서드에 대한 오류 코드를 반영합니다. 이 메서드가 S_FALSE 반환하는 이유는 다음과 같습니다.

  • 그래프가 완전히 빌드되었지만 다음 중 하나가 true입니다.
    • 오버레이 혼합이 작동하지 않습니다. 애플리케이션이 AM_DVD_NOVPE 플래그를 설정하지 않았고 오버레이 믹서에서 비디오 스트림을 넣을 수 없습니다. 이 경우 비디오가 소프트웨어에서 디코딩되면 애플리케이션에 비디오가 표시되지 않음을 사용자에게 알리기에 충분한 정보가 있습니다. 하드웨어 디코딩 비디오는 하드웨어 비디오 디코더의 NTSC 출력 포트에 연결된 TV에서만 볼 수 있습니다.
    • 비디오 디코더는 줄 21 데이터를 생성하지 않습니다. 애플리케이션은 디코더 때문에 선택 자막을 사용할 수 없다는 경고 또는 정보 메시지를 표시할 수 있습니다.
    • 볼륨 경로가 지정되지 않았으며 DVD 탐색기에서 재생할 DVD-Video 볼륨을 찾지 못했습니다. 재생이 시작될 때 드라이브에 사용할 수 있는 디스크가 없는 경우 애플리케이션에서 사용자에게 DVD-Video 디스크를 삽입하도록 요청할 수 있습니다.
  • 일부 스트림은 렌더링되지 않았습니다. 애플리케이션은 사용자에게 일부 스트림을 재생할 수 없음을 나타낼 수 있습니다.
이 메서드는 재생할 DVD-Video 파일 또는 볼륨에 대한 지식 없이 그래프를 빌드합니다. DVD-Video 그래프 작성기는 lpcwszPathName 이 NULL 이거나 DVD 탐색기 필터에서 재생할 기본 DVD-Video 볼륨을 찾지 못하는 경우에도 그래프를 빌드합니다.

요구 사항

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

추가 정보

DVD 응용 프로그램

오류 및 성공 코드

IDvdGraphBuilder 인터페이스