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

サポートが照会されるオーディオ ストリームの形式を指定する WAVEFORMATEX (mmeapi.h) 構造体へのポインター。

[out] frameCountPerBuffer

オーディオ デバイスでサポートされている最大フレーム数と指定された入力パラメーターを示す INT32 へのポインターを受け取ります。

戻り値

次の値を含む HRESULT。

値	説明
S_OK	Success
AUDCLNT_E_DEVICE_INVALIDATED	オーディオ クライアントに関連付けられているオーディオ デバイスが無効になっています。

注釈

このメソッドによって返される値を使用して、ソース バッファーを割り当てることができます。 エンドポイントの周期が変更されると、この値は変更されます。 呼び出し元は、ストリームの作成時に使用されるのと同じ AUDIO_STREAM_CATEGORY 値と WAVEFORMATEX 値を指定する必要があります。 ストリームがSPATIAL_AUDIO_STREAM_OPTIONS_OFFLOAD フラグで作成される場合は、offloadEnabled パラメーターを TRUE に設定する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows ビルド 22000
Header	spatialaudioclient.h