Méthode ISpatialAudioClient::IsSpatialAudioStreamAvailable (spatialaudioclient.h)
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 |
|---|---|
|
L’interface de flux spécifiée ne peut pas être activée par le moteur de rendu actuellement actif. |
|
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 |