ISpatialAudioObjectRenderStreamForHrtf::ActivateSpatialAudioObjectForHrtf メソッド (spatialaudiohrtf.h)

  • [アーティクル]

オーディオ レンダリング用に ISpatialAudioObjectForHrtf をアクティブにします。

構文

HRESULT ActivateSpatialAudioObjectForHrtf(
  [in]  AudioObjectType            type,
  [out] ISpatialAudioObjectForHrtf **audioObject
);

パラメーター

[in] type

アクティブにするオーディオ オブジェクトの種類。 動的オーディオ オブジェクトの場合、この値は AudioObjectType_Dynamicする必要があります。 静的オーディオ オブジェクトの場合は、 列挙の静的オーディオ チャネル値のいずれかを指定します。 AudioObjectType_Noneを指定すると、空間化されていないオーディオ オブジェクトが生成されます。

[out] audioObject

アクティブ化されたインターフェイスへのポインターを受け取ります。

戻り値

メソッドが成功した場合は、S_OK を返します。 エラーが発生した場合、次の表に示す値が、可能なリターン コードに含まれますが、これらに限定されません。

リターン コード 説明
SPTLAUDCLNT_E_NO_MORE_OBJECTS
システムは、同時オーディオ オブジェクトの最大数に達しました。
SPTLAUDCLNT_E_DESTROYED
 空間オーディオ ストリームに関連付けられている ISpatialAudioClient が破棄されました。
AUDCLNT_E_DEVICE_INVALIDATED
 オーディオ エンドポイント デバイスが取り外されているか、オーディオ ハードウェアまたは関連するハードウェア リソースが再構成、無効、削除、またはその他の方法で使用できなくなります。
SPTLAUDCLNT_E_INTERNAL
 内部エラーが発生しました。
AUDCLNT_E_UNSUPPORTED_FORMAT
 空間オーディオ ストリームに関連付けられているメディアでは、サポートされていない形式が使用されます。

解説

動的 ISpatialAudioObjectForHrtf は、 type パラメーターを ActivateSpatialAudioObjectForHrtf メソッドに AudioObjectType_Dynamicに設定することによってアクティブ化された値です。 クライアントには、一度にアクティブ化できる動的空間オーディオ オブジェクトの最大数の制限があります。 制限に達すると、追加のオーディオ オブジェクトをアクティブ化しようとすると、このメソッドから SPTLAUDCLNT_E_NO_MORE_OBJECTS エラーが返されます。 これを回避するには、リソースを解放して再割り当てできるようにリソースを解放するために使用されなくなった後、各動的 ISpatialAudioObjectForHrtf で Release を呼び出します。 空間オーディオ オブジェクトの有効期間の管理の詳細については、「 ISpatialAudioObjectgBase::IsActive 」および 「ISpatialAudioObjectgBase::SetEndOfStream 」を参照してください。

要件

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

関連項目

ISpatialAudioRenderStreamForHrtf