Metodo ISpatialAudioObjectRenderStream::ActivateSpatialAudioObject (spatialaudioclient.h)

Attiva un ISpatialAudioObject per il rendering audio.

Sintassi

HRESULT ActivateSpatialAudioObject(
  [in]  AudioObjectType     type,
  [out] ISpatialAudioObject **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 dell'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 possibili codici restituiti includono, ma non sono limitati, i valori illustrati nella tabella seguente.

Codice restituito Descrizione
SPTLAUDCLNT_E_NO_MORE_OBJECTS
Il sistema ha raggiunto il numero massimo di oggetti audio simultanei.
SPTLAUDCLNT_E_DESTROYED
ISpatialAudioClient associato al flusso audio spaziale è stato eliminato definitivamente.
AUDCLNT_E_DEVICE_INVALIDATED
Il dispositivo endpoint audio è stato scollegato oppure 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
Il supporto associato al flusso audio spaziale usa un formato non supportato.

Commenti

Un ISpatialAudioObject dinamico è uno attivato impostando il parametro di tipo sul metodo ActivateSpatialAudioObject su AudioObjectType_Dynamic. Il client ha un limite del numero massimo di oggetti audio spaziali dinamici che possono essere attivati contemporaneamente. Dopo aver raggiunto il limite, il tentativo di attivare oggetti audio aggiuntivi restituirà un errore di SPTLAUDCLNT_E_NO_MORE_OBJECTS. Per evitare questo problema, chiamare Release per ogni ISpatialAudioObject dinamico dopo che non viene più usato per liberare la risorsa in modo che possa essere riallocata. Per altre informazioni sulla gestione della durata degli oggetti audio spaziali, vedere ISpatialAudioObject::SetEndOfStream: ISpatialAudioObject::IsActive e ISpatialAudioObject::SetEndOfStream .

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione spatialaudioclient.h

Vedi anche

ISpatialAudioObjectRenderStream