ISpatialAudioObjectForHrtf::SetOrientation 方法 (spatialaudiohrtf.h)

設定 3D 空間中相對於接聽程式參考框架的方向,從中轉譯 ISpatialAudioObjectForHrtf 音訊資料。

語法

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

參數

[in] orientation

定義資料列主要 3x3 旋轉矩陣的浮點數陣列。

傳回值

如果方法成功,它會傳回 S_OK。 如果失敗,可能的傳回碼包括,但不限於下表所示的值。

傳回碼 Description
SPTLAUDCLNT_E_OUT_OF_ORDER

呼叫SetOrientation之前,未呼叫ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects

SPTLAUDCLNT_E_RESOURCES_INVALIDATED

SetEndOfStream 在先前的音訊處理階段中明確或隱含地呼叫。 如果ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjectS 和 ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjectsISpatialAudioObjectRenderStreamBase::EndUpdatingAudioObject) s之間的 (,則系統會隱含呼叫SetEndOfStream

備註

如果從未呼叫 SetOrientation ,則會使用識別矩陣的預設值。 呼叫 SetOrientation 之後,設定的方向將會用於音訊物件,直到方向變更為 SetOrientation的另一個呼叫為止。

規格需求

   
目標平台 Windows
標頭 spatialaudiohrtf.h

另請參閱

ISpatialAudioObjectForHrtf