Método ISpatialAudioObjectBase::IsActive (spatialaudioclient.h)

Obtém um valor booliano que indica se o ISpatialAudioObject é válido.

Sintaxe

HRESULT IsActive(
  [out] BOOL *isActive
);

Parâmetros

[out] isActive

TRUE se o objeto de áudio for válido no momento; caso contrário, FALSE.

Retornar valor

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

Comentários

Se esse valor for false, você deverá chamar Release para disponibilizar o recurso de objeto de áudio no futuro.

IsActive será definido como false depois que SetEndOfStream for chamado implicitamente ou explicitamente. SetEndOfStream será chamado implicitamente pelo sistema se GetBuffer não for chamado dentro de uma passagem de processamento de áudio (entre chamadas para ISpatialAudioObjectRenderStream::BeginUpdatingAudioObjects e ISpatialAudioObjectRenderStream::EndUpdatingAudioObjects).

O mecanismo de renderização também desativará o objeto de áudio, definindo IsActive como false, quando os recursos de objeto de áudio ficarem indisponíveis. Nesse caso, uma notificação é enviada por meio de ISpatialAudioObjectRenderStreamNotify antes que o objeto seja desativado. O valor retornado no parâmetro availableDynamicObjectCount para ISpatialAudioObjectRenderStream::BeginUpdatingAudioObjects indica quantos objetos serão processados para cada passagem.

Requisitos

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

Confira também

ISpatialAudioObject

ISpatialAudioObjectBase