Método ISpatialAudioObjectRenderStream::ActivateSpatialAudioObject (spatialaudioclient.h)

Activa un ISpatialAudioObject para la representación de audio.

Sintaxis

HRESULT ActivateSpatialAudioObject(
  [in]  AudioObjectType     type,
  [out] ISpatialAudioObject **audioObject
);

Parámetros

[in] type

Tipo de objeto de audio que se va a activar. Para los objetos de audio dinámicos, este valor debe ser AudioObjectType_Dynamic. Para los objetos de audio estáticos, especifique uno de los valores del canal de audio estático de la enumeración. Especificar AudioObjectType_None generará un objeto de audio que no está espacializado.

[out] audioObject

Recibe un puntero a la interfaz activada.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los posibles códigos de retorno incluyen, pero no están limitados a, los valores que se muestran en la tabla siguiente.

Código devuelto	Descripción
SPTLAUDCLNT_E_NO_MORE_OBJECTS	El sistema ha alcanzado el número máximo de objetos de audio simultáneos.
SPTLAUDCLNT_E_DESTROYED	ISpatialAudioClient asociado a la secuencia de audio espacial se ha destruido.
AUDCLNT_E_DEVICE_INVALIDATED	El dispositivo de punto de conexión de audio se ha desconectado o el hardware de audio o los recursos de hardware asociados se han reconfigurado, deshabilitado, quitado o no están disponibles para su uso.
SPTLAUDCLNT_E_INTERNAL	Se ha producido un error interno.
AUDCLNT_E_UNSUPPORTED_FORMAT	El medio asociado a la secuencia de audio espacial usa un formato no admitido.

Comentarios

Un ISpatialAudioObject dinámico es uno que se activó estableciendo el parámetro type en el método ActivateSpatialAudioObject en AudioObjectType_Dynamic. El cliente tiene un límite del número máximo de objetos de audio espacial dinámicos que se pueden activar a la vez. Una vez alcanzado el límite, si se intenta activar objetos de audio adicionales, este método devolverá un error de SPTLAUDCLNT_E_NO_MORE_OBJECTS. Para evitar esto, llame a Release en cada ISpatialAudioObject dinámico después de que ya no se use para liberar el recurso para que se pueda reasignar. Vea ISpatialAudioObject::IsActive e ISpatialAudioObject::SetEndOfStream para obtener más información sobre la administración de la duración de los objetos de audio espacial.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	spatialaudioclient.h

Consulte también

ISpatialAudioObjectRenderStream