ISpatialAudioObjectForHrtf::SetOrientation メソッド (spatialaudiohrtf.h)

ISpatialAudioObjectForHrtf オーディオデータのレンダリング元となるリスナーの参照フレームを基準にして、3D 空間の向きを設定します。

構文

HRESULT SetOrientation(
  [in] const SpatialAudioHrtfOrientation *orientation
);

[in] orientation

行メジャー 3 x 3 回転行列を定義する float の配列。

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

リターンコード	説明
SPTLAUDCLNT_E_OUT_OF_ORDER	ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects は、SetOrientation の呼び出しの前に呼び出されませんでした。
SPTLAUDCLNT_E_RESOURCES_INVALIDATED	SetEndOfStream は、以前のオーディオ処理パスで明示的または暗黙的に呼び出されました。 GetBuffer がオーディオ処理パス内で呼び出されない場合 (ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects と ISpatialAudioObjectRenderStreamBase::EndUpdatingAudioObjects の呼び出しの間)、SetEndOfStream はシステムによって暗黙的に呼び出されます。

リターンコード

説明

ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects は 、SetOrientation の呼び出しの前に呼び出されませんでした。

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

SetOrientation が呼び出されない場合は、ID マトリックスの既定値が使用されます。 SetOrientation が呼び出されると、SetOrientation の別の呼び出しで向きが変更されるまで、設定された方向がオーディオオブジェクトに使用されます。


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