Méthode ISpatialAudioClient::IsSpatialAudioStreamAvailable (spatialaudioclient.h)

  • Article

En cas de réussite, obtient une valeur indiquant si le moteur de rendu spatial actuellement actif prend en charge le flux de rendu audio spatial spécifié.

Syntaxe

HRESULT IsSpatialAudioStreamAvailable(
  [in]           REFIID            streamUuid,
  [in, optional] const PROPVARIANT *auxiliaryInfo
);

Paramètres

[in] streamUuid

ID d’interface de l’interface pour laquelle la disponibilité est interrogée.

[in, optional] auxiliaryInfo

Structure contenant des informations supplémentaires à utiliser lorsque la prise en charge est interrogée. Pour plus d'informations, consultez la section Notes.

Valeur retournée

Si la méthode réussit, retourne S_OK. En cas d’échec, les codes de retour possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.

Code de retour Description
SPTLAUDCLNT_E_STREAM_IS_NOT_AVAILABLE
 L’interface de flux spécifiée ne peut pas être activée par le moteur de rendu actuellement actif.
SPTLAUDCLNT_E_METADATA_FORMAT_IS_NOT_SUPPORTED
 Le format de métadonnées fourni dans le paramètre auxiliaryInfo n’est pas pris en charge par le moteur de rendu actuel. Pour plus d’informations, consultez Remarques.

Remarques

Lorsque vous interrogez pour voir si ISpatialAudioObjectRenderStreamForMetadata , vous pouvez utiliser le paramètre auxilaryInfo pour interroger si un format de métadonnées particulier est pris en charge. L’exemple de code suivant montre comment initialiser la structure PROPVARIANT pour case activée pour la prise en charge d’un exemple de format de métadonnées.

PROPVARIANT auxiliaryInfo;  
auxiliaryInfo.vt = VT_CLSID;  
auxiliaryInfo.puuid = const_cast<CLSID*>(&CONTOSO_SPATIAL_METADATA_V1_0);

Si le format de métadonnées spécifié n’est pas pris en charge, IsSpatialAudioStreamAvailable retourne SPTLAUDCLNT_E_METADATA_FORMAT_IS_NOT_SUPPORTED.

Configuration requise

   
Plateforme cible Windows
En-tête spatialaudioclient.h

Voir aussi

ISpatialAudioClient