ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects メソッド (spatialaudioclient.h)

  • [アーティクル]

オーディオ オブジェクト データを処理のために送信でき、 ISpatialAudioObject 状態を変更できる状態にシステムを配置します。

構文

HRESULT BeginUpdatingAudioObjects(
  [out] UINT32 *availableDynamicObjectCount,
  [out] UINT32 *frameCountPerBuffer
);

パラメーター

[out] availableDynamicObjectCount

現在の処理パスでレンダリングできる動的オーディオ オブジェクトの数。 割り当てられたすべての静的オーディオ オブジェクトは、すべてのパスでレンダリングできます。 オーディオ オブジェクトの種類の詳細については、「 AudioObjectType」を参照してください。

[out] frameCountPerBuffer

GetBuffer によって返されるバッファーのサイズ (オーディオ フレーム)。

戻り値

メソッドが成功した場合は、S_OK を返します。 失敗した場合、次の表に示す値が含まれますが、これに限定されません。

リターン コード 説明
SPTLAUDCLNT_E_OUT_OF_ORDER
 BeginUpdatingAudioObjects は、2 つの呼び出しの間に EndUpdatingAudioObjects を一致させる呼び出しなしで 2 回呼び出されました。
SPTLAUDCLNT_E_DESTROYED
 空間オーディオ ストリームに関連付けられている ISpatialAudioClient が破棄されました。
AUDCLNT_E_DEVICE_INVALIDATED
 オーディオ エンドポイント デバイスが取り外されているか、オーディオ ハードウェアまたは関連するハードウェア リソースが再構成、無効、削除、またはその他の方法で使用できなくなります。
AUDCLNT_E_RESOURCES_INVALIDATED
 空間オーディオ ストリームに関連付けられているリソースは無効です。
SPTLAUDCLNT_E_INTERNAL
 内部エラーが発生しました。
AUDCLNT_E_UNSUPPORTED_FORMAT
 空間オーディオ ストリームに関連付けられているメディアでは、サポートされていない形式が使用されます。

解説

このメソッドは、 SpatialAudioObjectRenderStreamActivationParams から ISpatialAudioClient::ActivateSpatialAudioStream に渡されるイベントがシグナル通知されるたびに呼び出す必要があります。
送信するオーディオ オブジェクト データがない場合でも。

BeginUpdatingAudioObjects 呼び出しごとに、EndUpdatingAudioObjects 呼び出しに対応する呼び出しが必要です。
BeginUpdatingAudioObjects が 2 回呼び出され、その間に EndUpdatingAudioObjects が呼び出されていない場合、2 番目の呼び出しは に対して行います。
BeginUpdatingAudioObjects はSPTLAUDCLNT_E_OUT_OF_ORDERを返します。

要件

   
対象プラットフォーム Windows
ヘッダー spatialaudioclient.h

関連項目

ISpatialAudioObjectRenderStream

ISpatialAudioObjectRenderStreamBase