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 になります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | spatialaudioclient.h |