ISpatialAudioClient：：IsSpatialAudioStreamAvailable 方法 (spatialaudioclient.h)

成功后，获取一个值，该值指示当前活动的空间呈现引擎是否支持指定的空间音频呈现流。

语法

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

[in] streamUuid

查询其可用性的接口的接口 ID。

[in, optional] auxiliaryInfo

包含查询支持时要使用的其他信息的结构。有关详细信息，请参阅“备注”。

如果该方法成功，则它会返回 S_OK。如果失败，可能的返回代码包括但不限于下表中显示的值。

返回代码	说明
SPTLAUDCLNT_E_STREAM_IS_NOT_AVAILABLE	当前处于活动状态的呈现引擎无法激活指定的流接口。
SPTLAUDCLNT_E_METADATA_FORMAT_IS_NOT_SUPPORTED	当前呈现引擎不支持在 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