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 |