Compartir a través de


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

Obtiene un valor booleano que indica si ISpatialAudioObject es válido.

Sintaxis

HRESULT IsActive(
  [out] BOOL *isActive
);

Parámetros

[out] isActive

TRUE si el objeto de audio es válido actualmente; de lo contrario, FALSE.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK.

Comentarios

Si este valor es false, debe llamar a Release para que el recurso de objeto de audio esté disponible en el futuro.

IsActive se establecerá en false después de llamar a SetEndOfStream de forma implícita o explícita. El sistema llama implícitamente a SetEndOfStream si no se llama a GetBuffer dentro de un paso de procesamiento de audio (entre llamadas a ISpatialAudioObjectRenderStream::BeginUpdatingAudioObjects e ISpatialAudioObjectRenderStream::EndUpdatingAudioObjects).

El motor de representación también desactivará el objeto de audio, estableciendo IsActive en false, cuando los recursos del objeto de audio dejan de estar disponibles. En este caso, se envía una notificación a través de ISpatialAudioObjectRenderStreamNotify antes de desactivar el objeto. El valor devuelto en el parámetro availableDynamicObjectCount a ISpatialAudioObjectRenderStream::BeginUpdatingAudioObjects indica cuántos objetos se procesarán para cada paso.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado spatialaudioclient.h

Consulte también

ISpatialAudioObject

ISpatialAudioObjectBase