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

  • Artículo

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