共用方式為

ISpatialAudioClient2：：GetMaxFrameCountForCategory 方法 (spatialaudioclient.h)

  • 發行項

取得每個處理階段支持的畫面計數上限。

語法

HRESULT GetMaxFrameCountForCategory(
  [in]  AUDIO_STREAM_CATEGORY category,
  [in]  BOOL                  offloadEnabled,
  [in]  const WAVEFORMATEX    *objectFormat,
  [out] UINT32                *frameCountPerBuffer
);

參數

[in] category

查詢支援的音頻數據流AUDIO_STREAM_CATEGORY (audiosessiontypes.h) 。

[in] offloadEnabled

布爾值，指定是否應該使用考慮音訊卸除支持來計算傳回的畫面計數。 如果此旗標設定為 true，則傳回的畫面計數就是當數據流啟用卸除模式時會是什麼。 不過，如果此旗標設定為 true，但音訊端點不支援卸除模式，則旗標不會有任何作用。 使用 ISpatialAudioClient2：：IsOffloadCapable 來檢查是否支援卸除模式。

[in] objectFormat

在 MMeapi.h (MMeapi.h ) 結構的指標，指定查詢支援的音訊數據流格式。

[out] frameCountPerBuffer

接收 INT32 的指標，指出音訊裝置和指定輸入參數支援的最大畫面數。

傳回值

HRESULT，包括下列值。

值 描述
S_OK Success
AUDCLNT_E_DEVICE_INVALIDATED 與音訊客戶端相關聯的音訊裝置已失效。

備註

這個方法傳回的值可用來配置來源緩衝區。 如果端點頻率變更，此值將會變更。 呼叫端必須指定在建立數據流時所使用的相同 AUDIO_STREAM_CATEGORY 和 「其」-[其][其] 值。 如果數據流會使用 SPATIAL_AUDIO_STREAM_OPTIONS_OFFLOAD 旗標建立數據流，則 offloadEnabled 參數必須設定為 TRUE。

規格需求

需求 值
最低支援的用戶端 Windows 組建 22000
標頭 spatialaudioclient.h