IDvdControl2::SelectVideoModePreference 메서드(strmif.h)

  • 아티클

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

메서드는 SelectVideoModePreference 재생을 위해 지정된 비디오 모드 표시(와이드 화면, 레터박스 또는 팬 스캔)를 설정합니다.

구문

HRESULT SelectVideoModePreference(
  [in] ULONG ulPreferredDisplayMode
);

매개 변수

[in] ulPreferredDisplayMode

DVD 콘텐츠에 대한 새 디스플레이 모드를 지정하는 값입니다. DVD_PREFERRED_DISPLAY_MODE 열거형의 멤버입니다.

반환 값

다음 값 중 하나를 반환합니다.

반환 코드 Description
S_OK
 성공.
E_INVALIDARG
 인수가 잘못되었습니다.
VFW_E_DVD_INVALIDDOMAIN
 도메인이 잘못되었습니다.
VFW_E_DVD_OPERATION_INHIBITED
 UOP 컨트롤은 작업을 금지합니다.

설명

이 메서드는 기본 비디오 창의 가로 세로 비율을 변경하고 기본 가로 세로 비율 변환 메커니즘을 지정할 수도 있습니다.

아나모픽 16 x 9 소스 비디오의 경우 720 x 480 원본 비디오를 16 x 9 가로 세로 비율로 확장하여 형성됩니다.

와이드 스크린 16 x 9 원본 비디오를 배치하고 클라이언트 출력 창의 가장 큰 16 x 9 영역으로 확장해야 합니다. 하이라이트는 16 x 9 영역의 내부를 기준으로 합니다. 16 x 9 영역을 유지하려면 위쪽/아래쪽 또는 측면에 검은색 막대를 추가해야 합니다.

Pan Scan 표시된 비디오는 늘어난 16 x 9 비디오에서 4 x 3 하위 창을 가져와 계산됩니다(가로 오프셋은 MPEG-2 비디오의 오프셋에 제공됨). 4 x 3 하위 창은 출력 클라이언트 창의 가장 큰 4 x 3 영역에 배치됩니다. 강조 표시의 좌표는 4 x 3 출력 창을 기준으로 하며 원본 16 x 9 비디오와 아무런 관계가 없습니다. 4 x 3 영역을 유지하려면 위쪽/아래쪽 또는 측면에 검은색 막대를 추가해야 합니다.

레터 박스 4 x 3 표시 영역은 출력 클라이언트 창에서 가장 큰 4 x 3 영역을 사용하여 형성됩니다. 4 x 3 영역을 유지하려면 위쪽/아래쪽 또는 측면에 검은색 막대를 추가해야 합니다. 원본 16 x 9 비디오는 4 x 3 하위 창 내에서 가장 큰 16 x 9 하위 창에 배치됩니다. 16 x 9 영역을 유지하려면 하위 창의 위쪽과 아래쪽에 검은색 막대를 추가해야 합니다. 강조 표시의 좌표는 4 x 3 하위 창에 상대적이며 원본 16 x 9 비디오와 아무런 관계가 없습니다. 기술적으로 디스크가 16 x 9 영역 외부에 있는 강조 표시를 지정할 수 있습니다(하지만 여전히 4 x 3 창에 있음).

4 x 3 비디오의 경우 비디오는 출력 클라이언트 창의 가장 큰 4 x 3 출력 영역에 배치됩니다. 4 x 3 영역을 유지하려면 위쪽/아래쪽 또는 측면에 검은색 막대를 추가해야 합니다.

다음 표에서는 이 메서드 이름이 해당하는 부록 J 명령 이름과 이 메서드가 유효한 도메인을 보여 줍니다.

부록 J 명령 이름 유효한 도메인
Video_Presentation_Mode_Change
  • DVD_DOMAIN_VideoManagerMenu
  • DVD_DOMAIN_VideoTitleSetMenu
  • DVD_DOMAIN_Title
  • DVD_DOMAIN_Stop

요구 사항

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

추가 정보

DVD 응용 프로그램

오류 및 성공 코드

IDvdControl2 인터페이스