ISpatialAudioObjectRenderStreamNotify::OnAvailableDynamicObjectCountChange メソッド (spatialaudioclient.h)

ISpatialAudioObjectRenderStream のレンダリング容量が変更されようとしているときに空間オーディオ クライアントに通知し、変更が発生するまでの時間を指定し、変更後に使用できる動的オーディオ オブジェクトの数を指定します。

構文

HRESULT OnAvailableDynamicObjectCountChange(
  [in] ISpatialAudioObjectRenderStreamBase *sender,
  [in] LONGLONG                            hnsComplianceDeadlineTime,
  [in] UINT32                              availableDynamicObjectCountChange
);

パラメーター

[in] sender

使用可能な動的オブジェクト数が変更される空間オーディオ レンダリング ストリーム。

[in] hnsComplianceDeadlineTime

空間リソースの制限が 100 ナノ秒単位で変更される時間。 値 0 は、変更が直ちに行われることを意味します。

[in] availableDynamicObjectCountChange

hnsComplianceDeadlineTime の後にストリームで使用できる動的空間オーディオ オブジェクトの数。

戻り値

メソッドが成功した場合は、S_OK を返します。 失敗した場合はエラー コードを返します。

解説

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

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

要件

こちらもご覧ください

ISpatialAudioObjectRenderStreamNotify