Share via


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

Define o tipo de ambiente acústico que é simulado quando o áudio é processado para o ISpatialAudioObjectForHrtf.

Sintaxe

HRESULT SetEnvironment(
  [in] SpatialAudioHrtfEnvironmentType environment
);

Parâmetros

[in] environment

Um valor que especifica o tipo de ambiente acústico que é simulado quando o áudio é processado para o ISpatialAudioObjectForHrtf.

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 SetEnvironment.

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

Se SetEnvironment não for chamado, o valor padrão de SpatialAudioHrtfEnvironment_Small será usado.

Requisitos

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

Confira também

ISpatialAudioObjectForHrtf