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

Coloca o sistema no estado em que os dados do objeto de áudio podem ser enviados para processamento e o estado ISpatialAudioObject pode ser modificado.

Sintaxe

HRESULT BeginUpdatingAudioObjects(
  [out] UINT32 *availableDynamicObjectCount,
  [out] UINT32 *frameCountPerBuffer
);

Parâmetros

[out] availableDynamicObjectCount

O número de objetos de áudio dinâmicos que estão disponíveis para serem renderizados para a passagem de processamento atual. Todos os objetos de áudio estático alocados podem ser renderizados em cada passagem. Para obter informações sobre tipos de objeto de áudio, consulte AudioObjectType.

[out] frameCountPerBuffer

O tamanho, em quadros de áudio, do buffer retornado por GetBuffer.

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_OUT_OF_ORDER	BeginUpdatingAudioObjects foi chamado duas vezes sem uma chamada correspondente para EndUpdatingAudioObjects entre as duas chamadas.
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.
AUDCLNT_E_RESOURCES_INVALIDATED	Um recurso associado ao fluxo de áudio espacial não é mais válido.
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

Esse método deve ser chamado sempre que o evento passado no SpatialAudioObjectRenderStreamActivationParams para ISpatialAudioClient::ActivateSpatialAudioStream é sinalizado,
mesmo que não haja dados de objeto de áudio a serem enviadas.

Para cada chamada BeginUpdatingAudioObjects , deve haver uma chamada correspondente para a chamada EndUpdatingAudioObjects .
Se BeginUpdatingAudioObjects for chamado duas vezes sem uma chamada EndUpdatingAudioObjects entre eles, a segunda chamada para
BeginUpdatingAudioObjects retornará SPTLAUDCLNT_E_OUT_OF_ORDER.

Requisitos

Plataforma de Destino	Windows
Cabeçalho	spatialaudioclient.h

Confira também

ISpatialAudioObjectRenderStream

ISpatialAudioObjectRenderStreamBase