Metodo ISpatialAudioClient::IsSpatialAudioStreamAvailable (spatialaudioclient.h)
In caso di esito positivo, ottiene un valore che indica se il motore di rendering spaziale attualmente attivo supporta il flusso di rendering audio spaziale specificato.
Sintassi
HRESULT IsSpatialAudioStreamAvailable(
[in] REFIID streamUuid,
[in, optional] const PROPVARIANT *auxiliaryInfo
);
Parametri
[in] streamUuid
ID interfaccia dell'interfaccia per cui viene eseguita una query sulla disponibilità.
[in, optional] auxiliaryInfo
Struttura contenente informazioni aggiuntive da usare quando viene eseguito una query sul supporto. Per altre informazioni, vedere la sezione Osservazioni.
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 |
|---|---|
|
L'interfaccia di flusso specificata non può essere attivata dal motore di rendering attualmente attivo. |
|
Il formato dei metadati fornito nel parametro ausiliarioInfo non è supportato dal motore di rendering corrente. Per altre informazioni, vedere Osservazioni.. |
Commenti
Quando si esegue una query per verificare se il parametro ISpatialAudioObjectRenderStreamForMetadata è possibile usare il parametro auxilaryInfo per eseguire query se è supportato un formato di metadati specifico. Nell'esempio di codice seguente viene illustrato come inizializzare la struttura PROPVARIANT per verificare la presenza del supporto per un formato di metadati di esempio.
PROPVARIANT auxiliaryInfo;
auxiliaryInfo.vt = VT_CLSID;
auxiliaryInfo.puuid = const_cast<CLSID*>(&CONTOSO_SPATIAL_METADATA_V1_0);
Se il formato di metadati specificato non è supportato, IsSpatialAudioStreamAvailable restituisce SPTLAUDCLNT_E_METADATA_FORMAT_IS_NOT_SUPPORTED.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | spatialaudioclient.h |