Metodo ISpatialAudioObjectRenderStreamForHrtf::ActivateSpatialAudioObjectForHrtf (spatialaudiohrtf.h)
Attiva un oggetto ISpatialAudioObjectForHrtf per il rendering audio.
Sintassi
HRESULT ActivateSpatialAudioObjectForHrtf(
[in] AudioObjectType type,
[out] ISpatialAudioObjectForHrtf **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 |
|---|---|
|
Il sistema ha raggiunto il numero massimo di oggetti audio simultanei. |
|
L'ISpatialAudioClient associato al flusso audio spaziale è stato distrutto. |
|
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. |
|
Si è verificato un errore interno. |
|
I supporti associati al flusso audio spaziale usano un formato non supportato. |
Commenti
Un oggetto ISpatialAudioObjectForHrtf dinamico è uno che è stato attivato impostando il parametro type sul metodo ActivateSpatialAudioObjectForHrtf 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 in ogni ISpatialAudioObjectForHrtf 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 ISpatialAudioObjectgBase::ISpatialAudioObjectgBase::SetEndOfStream.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | spatialaudiohrtf.h |