Compartilhar via


Método ISpatialAudioClient::GetMaxDynamicObjectCount (spatialaudioclient.h)

Obtém o número máximo de objetos de áudio dinâmicos para o cliente de áudio espacial.

Sintaxe

HRESULT GetMaxDynamicObjectCount(
  [out] UINT32 *value
);

Parâmetros

[out] value

Obtém a contagem máxima de objetos dinâmicos para este cliente.

Retornar valor

Se o método for bem-sucedido, retornará S_OK.

Comentários

Um ISpatialAudioObject dinâmico é aquele que foi ativado definindo o parâmetro de tipo como o método ISpatialAudioObjectRenderStream::ActivateSpatialAudioObject 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. Quando a capacidade do pipeline de renderização de áudio for alterada, o sistema ajustará dinamicamente o número máximo de objetos de áudio espaciais dinâmicos simultâneos. Antes disso, o sistema chamará OnAvailableDynamicObjectCountChange para notificar os clientes sobre a alteração do limite de recursos.

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.

Quando o Windows Sonic não estiver disponível (por exemplo, ao reproduzir em alto-falantes estéreo de laptop inseridos ou se o usuário não tiver habilitado explicitamente o Windows Sonic no dispositivo), o número de objetos dinâmicos disponíveis retornados por GetMaxDynamicObjectCount para um aplicativo será 0.

Requisitos

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

Confira também

ISpatialAudioClient