ISpatialAudioClient：：IsSpatialAudioStreamAvailable 方法 (spatialaudioclient.h)

  • 發行項

成功時，取得值，指出目前使用中的空間轉譯引擎是否支援指定的空間音訊轉譯資料流程。

語法

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

參數

[in] streamUuid

查詢可用性之介面的介面識別碼。

[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

另請參閱

ISpatialAudioClient