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

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

오디오 볼륨을 설정합니다.

구문

HRESULT SetVolume(
  [in] float flVolume
);

[in] flVolume

볼륨 수준입니다. 볼륨은 감쇠 수준으로 표현됩니다. 여기서 0.0은 무음, 1.0은 전체 볼륨(감쇠 없음)을 나타냅니다.

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

반환 코드	Description
S_OK	메서드가 성공했습니다.
MF_E_OUT_OF_RANGE	flVolume 매개 변수가 잘못되었습니다.

재생이 시작되기 전에 이 메서드를 호출하면 재생이 시작된 후 설정이 적용됩니다.

이 메서드는 플레이어의 오디오 세션에 대한 master 볼륨 수준을 변경하지 않습니다. 대신 현재 미디어 항목에 속하는 오디오 스트림의 채널별 볼륨 수준을 조정합니다. 오디오 세션의 다른 스트림은 영향을 받지 않습니다. 자세한 내용은 오디오 세션 관리를 참조하세요.