Metodo ISpatialAudioObjectRenderStreamForMetadata::ActivateSpatialAudioObjectForMetadataCommands (spatialaudiometadata.h)

Articolo
03/05/2024

Attivare un oggetto ISpatialAudioObjectForMetadataCommands per il rendering.

Sintassi

HRESULT ActivateSpatialAudioObjectForMetadataCommands(
  [in]  AudioObjectType                        type,
  [out] ISpatialAudioObjectForMetadataCommands **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 ISpatialAudioObjectForMetadataCommands dinamico è uno che è stato attivato impostando il parametro di tipo sul metodo ActivateSpatialAudioObjectForMetadataCommands su 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 su ogni ISpatialAudioObjectForMetadataCommands dopo che non viene più usato per liberare la risorsa in modo che possa essere riallocato. 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