ISpatialAudioClient::GetMaxDynamicObjectCount 方法 (spatialaudioclient.h)
取得空間音訊客戶端的動態音訊物件數目上限。
語法
HRESULT GetMaxDynamicObjectCount(
[out] UINT32 *value
);
參數
[out] value
取得這個用戶端的最大動態物件計數。
傳回值
如果方法成功,它會傳回 S_OK。
備註
動態 ISpatialAudioObject 是藉由將 類型 參數設定為 ISpatialAudioObjectRenderStream::ActivateSpatialAudioObject 方法來啟動的 ISpatialAudioObject 方法,以 AudioObjectType_Dynamic。 用戶端有一次可啟動的動態空間音頻物件數目上限。 當音訊轉譯管線的容量變更時,系統會動態調整並行動態空間音訊物件的最大數目。 這麼做之前,系統會呼叫 OnAvailableDynamicObjectCountChange 來通知用戶端資源限制變更。
當 ISpatialAudioObject 不再用來釋放資源以建立新的動態空間音訊物件時,請在 ISpatialAudioObject 上呼叫 Release。
例如,當 Windows Sonic 無法使用 (時,播放到內嵌膝上型膝上型電腦立體聲喇叭時,或使用者尚未在裝置上明確啟用 Windows Sonic ) ,GetMaxDynamicObjectCount 傳回給應用程式的可用動態物件數目將會是 0。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | spatialaudioclient.h |