ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects 方法 (spatialaudioclient.h)
將系統放入可以提交音訊物件資料進行處理的狀態,並修改 ISpatialAudioObject 狀態。
語法
HRESULT BeginUpdatingAudioObjects(
[out] UINT32 *availableDynamicObjectCount,
[out] UINT32 *frameCountPerBuffer
);
參數
[out] availableDynamicObjectCount
目前處理階段可用的動態音訊物件數目。 所有配置的靜態音訊物件都可以在每個階段中轉譯。 如需音訊物件類型的資訊,請參閱 AudioObjectType。
[out] frameCountPerBuffer
GetBuffer所傳回之緩衝區的大小,以音訊畫面為單位。
傳回值
如果方法成功,它會傳回 S_OK。 如果失敗,可能的傳回碼包括但不限於下表所示的值。
傳回碼 | 描述 |
---|---|
|
BeginUpdatingAudioObjects 在兩次呼叫之間沒有 對 EndUpdatingAudioObjects 的 相符呼叫。 |
|
與空間音訊資料流程相關聯的 ISpatialAudioClient 已終結。 |
|
音訊端點裝置已解除叢集,或音訊硬體或相關聯的硬體資源已重新設定、停用、移除或無法使用。 |
|
與空間音訊資料流程相關聯的資源已不再有效。 |
|
發生內部錯誤。 |
|
與空間音訊資料流程相關聯的媒體會使用不支援的格式。 |
備註
每次將 SpatialAudioObjectRenderStreamActivationParams 傳遞至 ISpatialAudioClient::ActivateSpatialAudioStream 時,都必須呼叫這個方法,
即使沒有要提交的音訊物件資料也一樣。
針對每個 BeginUpdatingAudioObjects 呼叫,應該會有對 EndUpdatingAudioObjects 呼叫的對應呼叫。
如果 BeginUpdatingAudioObjects 呼叫兩次,但不在兩者之間呼叫 EndUpdatingAudioObjects ,則第二次呼叫
BeginUpdatingAudioObjects 會傳回SPTLAUDCLNT_E_OUT_OF_ORDER。
規格需求
目標平台 | Windows |
標頭 | spatialaudioclient.h |