Método ISpatialAudioObjectForHrtf::SetGain (spatialaudiohrtf.h)

Define o ganho para o ISpatialAudioObjectForHrtf no banco de dados.

Sintaxe

HRESULT SetGain(
  [in] float gain
);

Parâmetros

[in] gain

O ganho para o ISpatialAudioObjectForHrtf no banco de dados.

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.

Código de retorno	Descrição
SPTLAUDCLNT_E_OUT_OF_ORDER	ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects não foi chamado antes da chamada para SetGain.
SPTLAUDCLNT_E_RESOURCES_INVALIDATED	SetEndOfStream foi chamado explicitamente ou implicitamente em uma passagem de processamento de áudio anterior. SetEndOfStream será chamado implicitamente pelo sistema se GetBuffer não for chamado dentro de uma passagem de processamento de áudio (entre chamadas para ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects e ISpatialAudioObjectRenderStreamBase::EndUpdatingAudioObjects).

Comentários

Isso é válido apenas para objetos de áudio espaciais configurados para usar o tipo de decaimento SpatialAudioHrtfDistanceDecay_CustomDecay . Defina o tipo de decaimento de um objeto ISpatialAudioObjectForHrtf chamando SetDistanceDecay. Defina o tipo de decaimento padrão para todos os objetos em um fluxo de renderização HRTF definindo o campo DistanceDecay do SpatialAudioHrtfActivationParams passado paraISpatialAudioClient::ActivateSpatialAudioStream.

Se SetGain nunca for chamado, o valor padrão de 0,0 será usado. Depois que SetGain for chamado, o ganho definido será usado para o objeto de áudio até que o ganho seja alterado com outra chamada para SetGain.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	spatialaudiohrtf.h

Confira também

ISpatialAudioObjectForHrtf