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 |
|---|---|
|
BeginUpdatingAudioObjects foi chamado duas vezes sem uma chamada correspondente para EndUpdatingAudioObjects entre as duas chamadas. |
|
O ISpatialAudioClient associado ao fluxo de áudio espacial foi destruído. |
|
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. |
|
Um recurso associado ao fluxo de áudio espacial não é mais válido. |
|
Ocorreu um erro interno. |
|
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 |