ISpatialAudioObjectRenderStreamBase：：BeginUpdatingAudioObjects 方法 (spatialaudioclient.h)

  • 發行項

將系統放入可以提交音訊物件資料進行處理的狀態，並修改 ISpatialAudioObject 狀態。

語法

HRESULT BeginUpdatingAudioObjects(
  [out] UINT32 *availableDynamicObjectCount,
  [out] UINT32 *frameCountPerBuffer
);

參數

[out] availableDynamicObjectCount

目前處理階段可用的動態音訊物件數目。 所有配置的靜態音訊物件都可以在每個階段中轉譯。 如需音訊物件類型的資訊，請參閱 AudioObjectType。

[out] frameCountPerBuffer

GetBuffer所傳回之緩衝區的大小，以音訊畫面為單位。

傳回值

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

傳回碼 描述
SPTLAUDCLNT_E_OUT_OF_ORDER
 BeginUpdatingAudioObjects 在兩次呼叫之間沒有 對 EndUpdatingAudioObjects 的 相符呼叫。
SPTLAUDCLNT_E_DESTROYED
 與空間音訊資料流程相關聯的 ISpatialAudioClient 已終結。
AUDCLNT_E_DEVICE_INVALIDATED
 音訊端點裝置已解除叢集，或音訊硬體或相關聯的硬體資源已重新設定、停用、移除或無法使用。
AUDCLNT_E_RESOURCES_INVALIDATED
 與空間音訊資料流程相關聯的資源已不再有效。
SPTLAUDCLNT_E_INTERNAL
 發生內部錯誤。
AUDCLNT_E_UNSUPPORTED_FORMAT
 與空間音訊資料流程相關聯的媒體會使用不支援的格式。

備註

每次將 SpatialAudioObjectRenderStreamActivationParams 傳遞至 ISpatialAudioClient：：ActivateSpatialAudioStream 時，都必須呼叫這個方法，
即使沒有要提交的音訊物件資料也一樣。

針對每個 BeginUpdatingAudioObjects 呼叫，應該會有對 EndUpdatingAudioObjects 呼叫的對應呼叫。
如果 BeginUpdatingAudioObjects 呼叫兩次，但不在兩者之間呼叫 EndUpdatingAudioObjects ，則第二次呼叫
BeginUpdatingAudioObjects 會傳回SPTLAUDCLNT_E_OUT_OF_ORDER。

規格需求

   
目標平台 Windows
標頭 spatialaudioclient.h

另請參閱

ISpatialAudioObjectRenderStream

ISpatialAudioObjectRenderStreamBase