Compartir a través de


Método ISpatialAudioObjectRenderStreamForMetadata::ActivateSpatialAudioObjectForMetadataCommands (spatialaudiometadata.h)

Active un ISpatialAudioObjectForMetadataCommands para su representación.

Sintaxis

HRESULT ActivateSpatialAudioObjectForMetadataCommands(
  [in]  AudioObjectType                        type,
  [out] ISpatialAudioObjectForMetadataCommands **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
Se ha superado el número máximo de objetos de audio espacial simultáneos. Llame a Release en objetos de audio sin usar antes de intentar activar objetos adicionales.
SPTLAUDCLNT_E_STATIC_OBJECT_NOT_AVAILABLE
El canal estático especificado en el parámetro type no se incluyó en el campo StaticObjectTypeMask del spatialAudioObjectRenderStreamForMetadataActivationParams pasado a ISpatialAudioClient::ActivateSpatialAudioStream.
SPTLAUDCLNT_E_OBJECT_ALREADY_ACTIVE
Ya se ha activado un objeto de audio espacial para el canal estático especificado en el parámetro type .
E_POINTER
El puntero proporcionado no es válido.
E_INVALIDARG
El valor especificado en el parámetro type no es uno de los valores definidos por la enumeración AudioObjectType .
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 ISpatialAudioObjectForMetadataCommands dinámico es uno que se activó estableciendo el parámetro de tipo en el método ActivateSpatialAudioObjectForMetadataCommands 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 ISpatialAudioObjectForMetadataCommands dinámico después de que ya no se use para liberar el recurso para que se pueda reasignar. Vea ISpatialAudioObjectBase::IsActive e ISpatialAudioObjectBase::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 spatialaudiometadata.h

Consulte también

ISpatialAudioObjectForMetadataItems