Metodo ISpatialAudioObjectRenderStreamForMetadata::ActivateSpatialAudioObjectForMetadataItems (spatialaudiometadata.h)

Articolo
03/15/2023

Attivare un oggetto ISpatialAudioObjectForMetadataItems per il rendering.

Sintassi

HRESULT ActivateSpatialAudioObjectForMetadataItems(
  [in]  AudioObjectType                     type,
  [out] ISpatialAudioObjectForMetadataItems **audioObject
);

Parametri

[in] type

Tipo di oggetto audio da attivare. Per gli oggetti audio dinamici, questo valore deve essere AudioObjectType_Dynamic. Per gli oggetti audio statici, specificare uno dei valori del canale audio statico dall'enumerazione. Se si specifica AudioObjectType_None , verrà generato un oggetto audio non spazializzato.

[out] audioObject

Riceve un puntatore all'interfaccia attivata.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i codici restituiti possibili includono, ma non sono limitati a, i valori visualizzati nella tabella seguente.

Codice restituito	Descrizione
SPTLAUDCLNT_E_NO_MORE_OBJECTS	Il numero massimo di oggetti audio spaziali simultanei è stato superato. Chiamare Release su oggetti audio inutilizzati prima di tentare di attivare oggetti aggiuntivi.
SPTLAUDCLNT_E_STATIC_OBJECT_NOT_AVAILABLE	Il canale statico specificato nel parametro di tipo non è stato incluso nel campo StaticObjectTypeMask del campo SpatialAudioObjectRenderStreamForMetadataActivationParams passato a ISpatialAudioClient::ActivateSpatialAudioStream.
SPTLAUDCLNT_E_OBJECT_ALREADY_ACTIVE	Un oggetto audio spaziale è già stato attivato per il canale statico specificato nel parametro di tipo .
E_POINTER	Il puntatore fornito non è valido.
E_INVALIDARG	Il valore specificato nel parametro di tipo non è uno dei valori definiti dall'enumerazione AudioObjectType .
SPTLAUDCLNT_E_DESTROYED	L'ISpatialAudioClient associato al flusso audio spaziale è stato distrutto.
AUDCLNT_E_DEVICE_INVALIDATED	Il dispositivo endpoint audio è stato scollegato o l'hardware audio o le risorse hardware associate sono state riconfigurate, disabilitate, rimosse o altrimenti non disponibili per l'uso.
SPTLAUDCLNT_E_INTERNAL	Si è verificato un errore interno.
AUDCLNT_E_UNSUPPORTED_FORMAT	I supporti associati al flusso audio spaziale usano un formato non supportato.

Commenti

Un oggetto ISpatialAudioObjectForMetadataItems dinamico è uno che è stato attivato impostando il parametro type sul metodo ActivateSpatialAudioObjectForMetadataItems per AudioObjectType_Dynamic. Il client ha un limite del numero massimo di oggetti audio spaziali dinamici che possono essere attivati alla volta. Dopo aver raggiunto il limite, il tentativo di attivare oggetti audio aggiuntivi comporterà la restituzione di un errore di SPTLAUDCLNT_E_NO_MORE_OBJECTS. Per evitare questo problema, chiamare Release in ogni ISpatialAudioObjectForMetadataItems dopo che non viene più usata per liberare la risorsa in modo che possa essere riallocata. Vedere ISpatialAudioObjectBase::IsActive e ISpatialAudioObjectBase::SetEndOfStream per altre informazioni sulla gestione della durata degli oggetti audio spaziali.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	spatialaudiometadata.h

Vedi anche

ISpatialAudioObjectForMetadataItems

Condividi tramite