ISpatialAudioObjectRenderStream::ActivateSpatialAudioObject メソッド (spatialaudioclient.h)

  • [アーティクル]

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

構文

HRESULT ActivateSpatialAudioObject(
  [in]  AudioObjectType     type,
  [out] ISpatialAudioObject **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
 空間オーディオ ストリームに関連付けられているメディアでは、サポートされていない形式が使用されます。

注釈

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

要件

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

こちらもご覧ください

ISpatialAudioObjectRenderStream