ISpatialAudioObjectForHrtf::SetGain 메서드(spatialaudiohrtf.h)

dB의 ISpatialAudioObjectForHrtf 에 대한 게인을 설정합니다.

구문

HRESULT SetGain(
  [in] float gain
);

[in] gain

dB의 ISpatialAudioObjectForHrtf 에 대한 게인입니다.

메서드가 성공하면 S_OK가 반환되고, 실패할 경우 가능한 반환 코드는 다음 표에 표시된 값을 포함하지만 이에 국한되지 않습니다.

반환 코드	설명
SPTLAUDCLNT_E_OUT_OF_ORDER	SetGain을 호출하기 전에 ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects가 호출되지 않았습니다.
SPTLAUDCLNT_E_RESOURCES_INVALIDATED	SetEndOfStream 은 이전 오디오 처리 단계에서 명시적으로 또는 암시적으로 호출되었습니다. GetBuffer가 오디오 처리 패스 내에서 호출되지 않는 경우 시스템에서 SetEndOfStream을 암시적으로 호출합니다(ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects 및 ISpatialAudioObjectRenderStreamBase::EndUpdatingAudioObjects 호출 사이).

반환 코드

설명

SetGain을 호출하기 전에 ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects가 호출되지 않았습니다.

SetEndOfStream 은 이전 오디오 처리 단계에서 명시적으로 또는 암시적으로 호출되었습니다. GetBuffer가 오디오 처리 패스 내에서 호출되지 않는 경우 시스템에서 SetEndOfStream을 암시적으로 호출합니다(ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects 및 ISpatialAudioObjectRenderStreamBase::EndUpdatingAudioObjects 호출 사이).

이는 SpatialAudioHrtfDistanceDecay_CustomDecay 감쇠 유형을 사용하도록 구성된 공간 오디오 개체에만 유효합니다. SetDistanceDecay를 호출하여 ISpatialAudioObjectForHrtf 개체의 감쇠 유형을 설정합니다. ISpatialAudioClient::ActivateSpatialAudioStream에 전달된 SpatialAudioHrtfActivationParams의 DistanceDecay 필드를 설정하여 HRTF 렌더링 스트림의 모든 개체에 대한 기본 감쇠 유형을 설정합니다.

SetGain을 호출하지 않으면 기본값 0.0이 사용됩니다. SetGain이 호출되면 SetGain에 대한 다른 호출로 게인이 변경될 때까지 설정된 게인이 오디오 개체에 사용됩니다.

요구 사항	값
대상 플랫폼	Windows
헤더	spatialaudiohrtf.h