IMFPMediaPlayer::SetVideoSourceRect 메서드(mfplay.h)

  • 아티클
중요 되지 않는. 이 API는 향후 Windows 릴리스에서 제거될 수 있습니다. 애플리케이션은 재생에 미디어 세션을 사용해야 합니다.
 

비디오 원본 사각형을 설정합니다.

MFPlay는 비디오를 이 사각형으로 잘라내고 사각형을 늘이면 비디오 창을 채웁니다.

구문

HRESULT SetVideoSourceRect(
  [in] const MFVideoNormalizedRect *pnrcSource
);

매개 변수

[in] pnrcSource

원본 사각형을 지정하는 MFVideoNormalizedRect 구조체에 대한 포인터입니다. 이 사각형은 비디오의 어떤 부분이 표시되는지 정의합니다. 다음과 같이 정의된 정규화된 좌표로 지정됩니다.

  • 비디오 이미지의 왼쪽 위 모서리는 (0, 0)입니다.
  • 비디오 이미지의 오른쪽 아래 모서리는 (1, 1)입니다.
전체 이미지를 표시하려면 원본 사각형을 {0, 0, 1, 1}으로 설정합니다. 이것은 기본값입니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드 Description
S_OK
 메서드가 성공했습니다.
MF_E_INVALIDREQUEST
 현재 미디어 항목에 비디오가 포함되어 있지 않습니다.
MF_E_SHUTDOWN
 개체의 Shutdown 메서드가 호출되었습니다.

설명

MFPlay는 원본 사각형을 늘여 전체 비디오 창을 채웁니다. 기본적으로 MFPlay는 원본의 올바른 가로 세로 비율(필요한 경우 레터박싱)을 유지합니다. 레터박스 색은 IMFPMediaPlayer::SetBorderColor 메서드에 의해 제어됩니다.

현재 설정된 미디어 항목이 없거나 현재 미디어 항목에 비디오가 없는 경우 이 메서드가 실패합니다.

재생이 시작되기 전에 비디오 위치를 설정하려면 MFP_EVENT_TYPE_MEDIAITEM_SET 이벤트에 대한 이벤트 처리기 내에서 이 메서드를 호출합니다. 자세한 내용은 IMFPMediaPlayerCallback::OnMediaPlayerEvent를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 mfplay.h

추가 정보

IMFPMediaPlayer

오디오/비디오 재생에 MFPlay 사용