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 |
---|---|
|
Il sistema ha raggiunto il numero massimo di oggetti audio simultanei. |
|
ISpatialAudioClient associato al flusso audio spaziale è stato eliminato definitivamente. |
|
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. |
|
Si è verificato un errore interno. |
|
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 |