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

Метод ISpatialAudioClient::GetStaticObjectPosition (spatialaudioclient.h)

  • Статья

Возвращает позицию в трехмерном пространстве указанного статического пространственного звукового канала.

Синтаксис

HRESULT GetStaticObjectPosition(
  [in]  AudioObjectType type,
  [out] float           *x,
  [out] float           *y,
  [out] float           *z
);

Параметры

[in] type

Значение , указывающее статический пространственный аудиоканал, для которого запрашивается позиция. Этот метод возвращает E_INVALIDARG, если значение не представляет статический канал, включая AudioObjectType_Dynamic и AudioObjectType_None.

[out] x

Координата x статического звукового канала в метрах относительно прослушивателя. Положительные значения находятся справа от прослушивателя, а отрицательные — слева.

[out] y

Координата y статического звукового канала в метрах относительно прослушивателя. Положительные значения выше прослушивателя, а отрицательные — ниже.

[out] z

Координата Z статического звукового канала в метрах относительно прослушивателя. Положительные значения находятся за прослушивателем, а отрицательные — впереди.

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

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

Код возврата Описание
E_INVALIDARG
 Предоставленное значение AudioObjectType не представляет статический канал.

Комментарии

Значения позиций используют правую декартовую систему координат, где каждая единица представляет 1 метр. Система координат находится относительно прослушивателя, где источник (x=0,0, y=0,0, z=0,0) представляет центральную точку между ушами прослушивателя.

Требования

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

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

ISpatialAudioClient