Compartir a través de


Método ISpatialAudioObjectRenderStreamForHrtf::ActivateSpatialAudioObjectForHrtf (spatialaudiohrtf.h)

Activa un ISpatialAudioObjectForHrtf para la representación de audio.

Sintaxis

HRESULT ActivateSpatialAudioObjectForHrtf(
  [in]  AudioObjectType            type,
  [out] ISpatialAudioObjectForHrtf **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 ISpatialAudioObjectForHrtf dinámico es uno que se activó estableciendo el parámetro type en el método ActivateSpatialAudioObjectForHrtf 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 ISpatialAudioObjectForHrtf dinámico después de que ya no se use para liberar el recurso para que se pueda reasignar. Vea ISpatialAudioObjectgBase::IsActive e ISpatialAudioObjectgBase::SetEndOfStream para obtener más información sobre la administración de la duración de los objetos de audio espacial.

Requisitos

   
Plataforma de destino Windows
Encabezado spatialaudiohrtf.h

Consulte también

ISpatialAudioRenderStreamForHrtf