Поделиться через


Метод ISpatialAudioObjectForHrtf::SetOrientation (spatialaudiohrtf.h)

Задает ориентацию в трехмерном пространстве относительно системы отсчета прослушивателя, из которой будут отображаться звуковые данные ISpatialAudioObjectForHrtf .

Синтаксис

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

Параметры

[in] orientation

Массив с плавающей точкой, определяющий матрицу поворота основной строки 3x3.

Возвращаемое значение

Если метод завершается успешно, возвращает значение S_OK. В случае сбоя возможные коды возврата включают, но не ограничиваются ими, значения, показанные в следующей таблице.

Код возврата Описание
SPTLAUDCLNT_E_OUT_OF_ORDER

ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects не был вызван до вызова SetOrientation.

SPTLAUDCLNT_E_RESOURCES_INVALIDATED

Метод SetEndOfStream был вызван явно или неявно в предыдущем проходе обработки звука. SetEndOfStream вызывается системой неявно, если GetBuffer не вызывается в рамках прохода обработки звука (между вызовами ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects и ISpatialAudioObjectRenderStreamBase::EndUpdatingAudioObjects).

Комментарии

Если Метод SetOrientation никогда не вызывается, используется значение по умолчанию матрицы удостоверений. После вызова SetOrientation заданная ориентация будет использоваться для звукового объекта до тех пор, пока ориентация не будет изменена при другом вызове Метода SetOrientation.

Требования

   
Целевая платформа Windows
Header spatialaudiohrtf.h

См. также раздел

ISpatialAudioObjectForHrtf