ISpatialAudioObjectBase::IsActive メソッド (spatialaudioclient.h)

  • [アーティクル]

ISpatialAudioObject が有効かどうかを示すブール値を取得します。

構文

HRESULT IsActive(
  [out] BOOL *isActive
);

パラメーター

[out] isActive

オーディオ オブジェクトが現在有効な場合は TRUE。それ以外の場合は FALSE。

戻り値

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

注釈

この値が false の場合は、 Release を呼び出して、オーディオ オブジェクト リソースを将来使用できるようにします。

SetEndOfStream が暗黙的または明示的に呼び出された後、IsActive は false に設定されます。 GetBuffer がオーディオ処理パス内で呼び出されない場合 、SetEndOfStream はシステムによって暗黙的に呼び出されます (ISpatialAudioObjectRenderStream::BeginUpdatingAudioObjects と ISpatialAudioObjectRenderStream::EndUpdatingAudioObjects の呼び出しの間)。

また、オーディオ オブジェクトリソースが使用できなくなった場合、レンダリング エンジンはオーディオ オブジェクトを非アクティブ化し、 IsActive を false に設定します。 この場合、オブジェクトが非アクティブ化される前に 、ISpatialAudioObjectRenderStreamNotify 経由で通知が送信されます。 ISpatialAudioObjectRenderStream::BeginUpdatingAudioObjects に対して availableDynamicObjectCount パラメーターで返される値は、各パスで処理されるオブジェクトの数を示します。

要件

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

こちらもご覧ください

ISpatialAudioObject

ISpatialAudioObjectBase