Metodo ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects (spatialaudioclient.h)
Inserisce il sistema nello stato in cui è possibile inviare i dati dell'oggetto audio per l'elaborazione e lo stato ISpatialAudioObject può essere modificato.
Sintassi
HRESULT BeginUpdatingAudioObjects(
[out] UINT32 *availableDynamicObjectCount,
[out] UINT32 *frameCountPerBuffer
);
Parametri
[out] availableDynamicObjectCount
Numero di oggetti audio dinamici disponibili per il rendering per il passaggio di elaborazione corrente. Tutti gli oggetti audio statici allocati possono essere sottoposti a rendering in ogni passaggio. Per informazioni sui tipi di oggetti audio, vedere AudioObjectType.
[out] frameCountPerBuffer
Dimensioni, in fotogrammi audio, del buffer restituito da GetBuffer.
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 |
|---|---|
|
BeginUpdatingAudioObjects è stato chiamato due volte senza una chiamata corrispondente a EndUpdatingAudioObjects tra le due chiamate. |
|
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. |
|
Una risorsa associata al flusso audio spaziale non è più valida. |
|
Si è verificato un errore interno. |
|
I supporti associati al flusso audio spaziale usano un formato non supportato. |
Commenti
Questo metodo deve essere chiamato ogni volta che l'evento passato in SpatialAudioObjectRenderStreamActivationParams a ISpatialAudioClient::ActivateSpatialAudioStream viene segnalato,
anche se non sono presenti dati dell'oggetto audio da inviare.
Per ogni chiamata BeginUpdatingAudioObjects , deve essere presente una chiamata corrispondente alla chiamata EndUpdatingAudioObjects .
Se BeginUpdatingAudioObjects viene chiamato due volte senza una chiamata EndUpdatingAudioObjects tra di essi, la seconda chiamata a
BeginUpdatingAudioObjects restituirà SPTLAUDCLNT_E_OUT_OF_ORDER.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | spatialaudioclient.h |