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 구현 반환 값에는 다음이 포함됩니다.
| 반환 코드 | 설명 |
|---|---|
|
dwFlags 매개 변수는 충돌하는 옵션을 지정합니다. |
|
메서드가 부분적으로 성공했습니다. 발생한 오류를 확인하려면 pStatus 매개 변수를 검사합니다. |
|
메서드가 성공했고 모든 스트림이 렌더링되었습니다. |
|
하나 이상의 스트림을 렌더링할 수 없습니다.
dwFlags 매개 변수에서 AM_DVD_HWDEC_ONLY 또는 AM_DVD_SWDEC_ONLY 플래그를 지정한 경우 AM_DVD_HWDEC_PREFER 또는 AM_DVD_SWDEC_PREFER 플래그를 사용하여 메서드를 다시 호출해 보세요. |
|
필터 그래프에는 이미 비디오 렌더러가 포함되어 있습니다. 메서드는 dwFlags 매개 변수에서 AM_DVD_EVR_ONLY 플래그를 지정하지만 그래프에 VMR(고급 비디오 렌더러) 필터 이외의 비디오 렌더러가 이미 포함되어 있는 경우 이 오류 코드를 반환합니다. |
|
그래프를 작성하는 동안 오류가 발생했습니다. 예를 들어 DVD Graph Builder에서 필요한 필터를 만들 수 없거나 스트림을 렌더링할 수 없습니다. |
|
필터 그래프에는 둘 이상의 비디오 렌더러가 포함되어 있습니다. |
설명
AM_DVD_RENDERSTATUS 구조는 이 메서드에 대한 오류 코드를 반영합니다. 이 메서드가 S_FALSE 반환하는 이유는 다음과 같습니다.
- 그래프가 완전히 빌드되었지만 다음 중 하나가 true입니다.
- 오버레이 혼합이 작동하지 않습니다. 애플리케이션이 AM_DVD_NOVPE 플래그를 설정하지 않았고 오버레이 믹서에서 비디오 스트림을 넣을 수 없습니다. 이 경우 비디오가 소프트웨어에서 디코딩되면 애플리케이션에 비디오가 표시되지 않음을 사용자에게 알리기에 충분한 정보가 있습니다. 하드웨어 디코딩 비디오는 하드웨어 비디오 디코더의 NTSC 출력 포트에 연결된 TV에서만 볼 수 있습니다.
- 비디오 디코더는 줄 21 데이터를 생성하지 않습니다. 애플리케이션은 디코더 때문에 선택 자막을 사용할 수 없다는 경고 또는 정보 메시지를 표시할 수 있습니다.
- 볼륨 경로가 지정되지 않았으며 DVD 탐색기에서 재생할 DVD-Video 볼륨을 찾지 못했습니다. 재생이 시작될 때 드라이브에 사용할 수 있는 디스크가 없는 경우 애플리케이션에서 사용자에게 DVD-Video 디스크를 삽입하도록 요청할 수 있습니다.
- 일부 스트림은 렌더링되지 않았습니다. 애플리케이션은 사용자에게 일부 스트림을 재생할 수 없음을 나타낼 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | strmif.h(Dshow.h 포함) |
| 라이브러리 | Strmiids.lib |