ISpatialAudioClient::IsSpatialAudioStreamAvailable 方法 (spatialaudioclient.h)
成功時,取得值,指出目前使用中的空間轉譯引擎是否支援指定的空間音訊轉譯資料流程。
語法
HRESULT IsSpatialAudioStreamAvailable(
[in] REFIID streamUuid,
[in, optional] const PROPVARIANT *auxiliaryInfo
);
參數
[in] streamUuid
查詢可用性之介面的介面識別碼。
[in, optional] auxiliaryInfo
結構,包含查詢支援時要使用的其他資訊。 如需詳細資訊,請參閱<備註>。
傳回值
如果方法成功,它會傳回 S_OK。 如果失敗,可能的傳回碼包括,但不限於下表所示的值。
傳回碼 | 描述 |
---|---|
|
目前作用中的轉譯引擎無法啟動指定的資料流程介面。 |
|
目前轉譯引擎不支援 在 auxiliaryInfo 參數中提供的元資料格式。 如需詳細資訊,請參閱。 |
備註
查詢以查看 ISpatialAudioObjectRenderStreamForMetadata 時,您可以使用 auxilaryInfo 參數來查詢是否支援特定元資料格式。 下列程式碼範例示範如何初始化 PROPVARIANT 結構,以檢查範例元資料格式的支援。
PROPVARIANT auxiliaryInfo;
auxiliaryInfo.vt = VT_CLSID;
auxiliaryInfo.puuid = const_cast<CLSID*>(&CONTOSO_SPATIAL_METADATA_V1_0);
如果不支援指定的元資料格式, IsSpatialAudioStreamAvailable 會傳回SPTLAUDCLNT_E_METADATA_FORMAT_IS_NOT_SUPPORTED。
需求
目標平台 | Windows |
標頭 | spatialaudioclient.h |