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

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

 

재생 속도를 설정합니다.

구문

HRESULT SetRate(
  [in] float flRate
);

매개 변수

[in] flRate

재생 속도. 재생 속도는 정상 속도에 대한 현재 속도의 비율로 표현됩니다. 예를 들어 1.0 은 정상적인 재생 속도를 나타내고 0.5 는 절반 속도를 나타내고 2.0 은 두 배의 속도를 나타냅니다. 양수 값은 정방향 재생을 나타내고 음수 값은 역방향 재생을 나타냅니다.

반환 값

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

반환 코드	설명
S_OK	메서드가 성공했습니다.
MF_E_OUT_OF_RANGE	flRate 매개 변수는 0입니다.
MF_E_SHUTDOWN	개체의 Shutdown 메서드가 호출되었습니다.

설명

이 메서드는 비동기적으로 완료됩니다. 작업이 완료되면 애플리케이션의 IMFPMediaPlayerCallback::OnMediaPlayerEvent 콜백 메서드가 호출됩니다. 이벤트 유형이 MFP_EVENT_TYPE_RATE_SET.

메서드는 기본 미디어 원본에 따라 가장 가까운 지원 속도를 설정합니다. 예를 들어 flRate 가 50이고 원본의 최대 속도가 8× 정상 속도인 경우 메서드는 속도를 8.0으로 설정합니다. 실제 속도는 MFP_EVENT_TYPE_RATE_SET 이벤트에 대한 이벤트 데이터에 표시됩니다.

지원되는 요금 범위를 찾으려면 IMFPMediaPlayer::GetSupportedRates를 호출합니다.

Media Foundation은 다른 컨텍스트에서 0 속도에 대한 의미를 정의하지만 이 메서드는 0의 재생 속도를 지원하지 않습니다.

새 속도는 현재 미디어 항목에만 적용됩니다. 새 미디어 항목을 설정하면 재생 속도가 1.0으로 다시 설정됩니다.

요구 사항

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

추가 정보

IMFPMediaPlayer

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