Método ISpatialAudioObjectRenderStreamForHrtf::ActivateSpatialAudioObjectForHrtf (spatialaudiohrtf.h)

  • Artigo

Ativa um ISpatialAudioObjectForHrtf para renderização de áudio.

Sintaxe

HRESULT ActivateSpatialAudioObjectForHrtf(
  [in]  AudioObjectType            type,
  [out] ISpatialAudioObjectForHrtf **audioObject
);

Parâmetros

[in] type

O tipo de objeto de áudio a ser ativado. Para objetos de áudio dinâmicos, esse valor deve ser AudioObjectType_Dynamic. Para objetos de áudio estáticos, especifique um dos valores de canal de áudio estático da enumeração. Especificar AudioObjectType_None produzirá um objeto de áudio que não é espacializado.

[out] audioObject

Recebe um ponteiro para a interface ativada.

Valor retornado

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_NO_MORE_OBJECTS
O sistema atingiu o número máximo de objetos de áudio simultâneos.
SPTLAUDCLNT_E_DESTROYED
 O ISpatialAudioClient associado ao fluxo de áudio espacial foi destruído.
AUDCLNT_E_DEVICE_INVALIDATED
 O dispositivo de ponto de extremidade de áudio foi desconectado ou o hardware de áudio ou os recursos de hardware associados foram reconfigurados, desabilitados, removidos ou não estão disponíveis para uso.
SPTLAUDCLNT_E_INTERNAL
 Ocorreu um erro interno.
AUDCLNT_E_UNSUPPORTED_FORMAT
 A mídia associada ao fluxo de áudio espacial usa um formato sem suporte.

Comentários

Um ISpatialAudioObjectForHrtf dinâmico é aquele que foi ativado definindo o parâmetro de tipo como o método ActivateSpatialAudioObjectForHrtf para AudioObjectType_Dynamic. O cliente tem um limite do número máximo de objetos de áudio espacial dinâmicos que podem ser ativados ao mesmo tempo. Depois que o limite for atingido, a tentativa de ativar objetos de áudio adicionais resultará no retorno de um erro de SPTLAUDCLNT_E_NO_MORE_OBJECTS. Para evitar isso, chame Release em cada ISpatialAudioObjectForHrtf dinâmico depois que ele não estiver mais sendo usado para liberar o recurso para que ele possa ser realocado. Consulte ISpatialAudioObjectgBase::IsActive e ISpatialAudioObjectgBase::SetEndOfStream para obter mais informações sobre como gerenciar o tempo de vida de objetos de áudio espaciais.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho spatialaudiohrtf.h

Confira também

ISpatialAudioRenderStreamForHrtf