Método ISpatialAudioObjectRenderStreamBase::GetAvailableDynamicObjectCount (spatialaudioclient.h)

  • Artigo

Obtém o número de objetos de áudio espacial dinâmicos que estão disponíveis no momento.

Sintaxe

HRESULT GetAvailableDynamicObjectCount(
  [out] UINT32 *value
);

Parâmetros

[out] value

O número de objetos de áudio espacial dinâmicos que estão disponíveis no momento.

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.

Comentários

Um ISpatialAudioObject dinâmico é aquele que foi ativado definindo o parâmetro de tipo como o método ActivateSpatialAudioObject para AudioObjectType_Dynamic. O sistema tem um limite do número máximo de objetos de áudio espacial dinâmicos que podem ser ativados ao mesmo tempo. Chame Release em um ISpatialAudioObject quando ele não estiver mais sendo usado para liberar o recurso para criar novos objetos de áudio espacial dinâmicos.

Você não deve chamar esse método após o início do streaming, pois o valor já é fornecido por ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects. Esse método só deve ser chamado antes do streaming ser iniciado, o que ocorre depois que ISpatialAudioObjectRenderStreamBase::Start é chamado.

Requisitos

Código de retorno Descrição
SPTLAUDCLNT_E_DESTROYED
 O ISpatialAudioClient associado ao fluxo de áudio espacial foi destruído.
AUDCLNT_E_DEVICE_INVALIDATED
 O dispositivo de áudio associado ao fluxo de áudio espacial não é mais válido.
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 indisponí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.
   
Plataforma de Destino Windows
Cabeçalho spatialaudioclient.h

Confira também

ISpatialAudioObjectRenderStream

ISpatialAudioObjectRenderStreamBase