ISpatialAudioClient::IsSpatialAudioStreamAvailable 方法 (spatialaudioclient.h)
成功后,获取一个值,该值指示当前活动的空间呈现引擎是否支持指定的空间音频呈现流。
语法
HRESULT IsSpatialAudioStreamAvailable(
[in] REFIID streamUuid,
[in, optional] const PROPVARIANT *auxiliaryInfo
);
参数
[in] streamUuid
查询其可用性的接口的接口 ID。
[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 |