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