Condividi tramite

Riprendersi da un errore Invalid-Device (suono spaziale)

Molti dei metodi dell'API Audio spaziale Microsoft, ad esempio ISpatialAudioClient, ISpatialAudioObjectRenderStreame ISpatialAudioObject, restituiscono codici di errore se il dispositivo endpoint audio usato dall'applicazione client diventa non valido o il formato di rendering audio spaziale viene modificato nell'endpoint. Questi codici di errore indicano che il dispositivo endpoint è stato scollegato o che l'hardware audio o le risorse hardware associate sono state riconfigurate, disabilitate, rimosse, la modalità audio spaziale viene modificata o altrimenti resa non disponibile per l'uso. Spesso, l'applicazione può recuperare da questo errore.

I codici di errore che indicano un errore di dispositivo non valido includono quanto segue:

  • SPTLAUDCLNT_E_DESTROYED
  • AUDCLNT_E_DEVICE_INVALIDATED
  • AUDCLNT_E_RESOURCES_INVALIDATED
  • AUDCLNT_E_UNSUPPORTED_FORMAT
  • SPTLAUDCLNT_E_INTERNAL

Strategie per la gestione degli errori di dispositivo non valido

La strategia consigliata per il ripristino da un errore di dispositivo non valido dipende dal fatto che l'applicazione selezioni automaticamente un dispositivo specifico in base ai requisiti interni o consenta all'utente di selezionare in modo esplicito un dispositivo da un elenco di dispositivi disponibili.

Dispositivo audio predefinito

Se l'applicazione seleziona automaticamente il dispositivo predefinito, seguire questa procedura per eseguire il ripristino.

  1. Rilasciare interfaccia ISpatialAudioObjectRenderStream e interfaccia ISpatialAudioClient e qualsiasi altra interfaccia audio spaziale usata per il rendering.
  2. Chiama IMMDeviceEnumerator::GetDefaultAudioEndpoint per ottenere il dispositivo audio predefinito corrente.
  3. Provare ad attivare ISpatialAudioClient nel dispositivo audio.
  4. Attivare ISpatialAudioObjectRenderStream.

Dispositivo audio specifico selezionato

Se l'applicazione seleziona un dispositivo audio specifico, seguire questa procedura per eseguire il ripristino.

  1. Rilasciare l'interfaccia ISpatialAudioObjectRenderStream e qualsiasi altra interfaccia audio spaziale usata per il rendering, ma non rilasciare ISpatialAudioClient.
  2. Usare l'istanza corrente di ISpatialAudioClient per attivare ISpatialAudioObjectRenderStream.

Si noti che per entrambe le strategie elencate in precedenza, è possibile applicare gli stessi passaggi alle applicazioni che usano le interfacce ISpatialAudioObjectRenderStreamForMetadata o ISpatialAudioObjectRenderStreamForHrtf. È sufficiente sostituire ISpatialAudioObjectRenderStream nei passaggi precedenti con i metadati o le interfacce Hrtf.

[Recupero da un errore Invalid-Device](recovering-from-an-invalid-device-error.md) [Gestione del flusso](stream-management.md)