ISpatialAudioClient::GetMaxDynamicObjectCount メソッド (spatialaudioclient.h)

空間オーディオ クライアントの動的オーディオ オブジェクトの最大数を取得します。

構文

HRESULT GetMaxDynamicObjectCount(
  [out] UINT32 *value
);

パラメーター

[out] value

このクライアントの最大動的オブジェクト数を取得します。

戻り値

メソッドが成功した場合は、S_OK を返します。

注釈

動的 ISpatialAudioObject は、 type パラメーターを ISpatialAudioObjectRenderStream::ActivateSpatialAudioObject メソッドに設定して AudioObjectType_Dynamicすることによってアクティブ化されたオブジェクトです。 クライアントには、一度にアクティブ化できる動的空間オーディオ オブジェクトの最大数の制限があります。 オーディオ レンダリング パイプラインの容量が変更されると、システムは同時動的空間オーディオ オブジェクトの最大数を動的に調整します。 その前に、システムは OnAvailableDynamicObjectCountChange を呼び出して、リソース制限の変更をクライアントに通知します。

リソースを解放して新しい動的空間オーディオ オブジェクトを作成するために使用されなくなった場合は、ISpatialAudioObject で Release を呼び出します。

Windows Sonic が使用できない場合 (たとえば、埋め込みノート PC ステレオ スピーカーで再生するとき、またはユーザーがデバイスで Windows Sonic を明示的に有効にしていない場合)、 GetMaxDynamicObjectCount によってアプリケーションに返される使用可能な動的オブジェクトの数は 0 になります。

要件

こちらもご覧ください

ISpatialAudioClient