ISpatialAudioObjectRenderStreamBase::GetAvailableDynamicObjectCount 方法 (spatialaudioclient.h)

取得目前可用的動態空間音訊物件數目。

語法

HRESULT GetAvailableDynamicObjectCount(
  [out] UINT32 *value
);

參數

[out] value

目前可用的動態空間音訊物件數目。

傳回值

如果方法成功,它會傳回 S_OK。 如果失敗,可能的傳回碼包括但不限於下表所示的值。

備註

動態ISpatialAudioObject是藉由將type參數設定為ActivateSpatialAudioObject 方法來啟動的動態 ISpatialAudioObjectAudioObjectType_Dynamic。 系統會限制一次可以啟動的動態空間音訊物件數目上限。 當ISpatialAudioObject不再用來釋出資源以建立新的動態空間音訊物件時,請在 ISpatialAudioObject 上呼叫Release

串流啟動之後,您不應該呼叫這個方法,因為 ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects已提供此值。 只有在串流啟動之前,才應該呼叫這個方法,這會在 呼叫 ISpatialAudioObjectRenderStreamBase::Start 之後發生。

需求

傳回碼 描述
SPTLAUDCLNT_E_DESTROYED
與空間音訊資料流程相關聯的 ISpatialAudioClient 已終結。
AUDCLNT_E_DEVICE_INVALIDATED
與空間音訊資料流程相關聯的音訊裝置已不再有效。
AUDCLNT_E_DEVICE_INVALIDATED
音訊端點裝置已解除叢集,或音訊硬體或相關聯的硬體資源已重新設定、停用、移除或無法使用。
SPTLAUDCLNT_E_INTERNAL
發生內部錯誤。
AUDCLNT_E_UNSUPPORTED_FORMAT
與空間音訊資料流程相關聯的媒體會使用不支援的格式。
   
目標平台 Windows
標頭 spatialaudioclient.h

另請參閱

ISpatialAudioObjectRenderStream

ISpatialAudioObjectRenderStreamBase