структура KSDS3D_BUFFER_ALL (ksmedia.h)

Структура KSDS3D_BUFFER_ALL указывает все трехмерные характеристики буфера DirectSound 3D.

Синтаксис

typedef struct {
  DS3DVECTOR Position;
  DS3DVECTOR Velocity;
  ULONG      InsideConeAngle;
  ULONG      OutsideConeAngle;
  DS3DVECTOR ConeOrientation;
  LONG       ConeOutsideVolume;
  FLOAT      MinDistance;
  FLOAT      MaxDistance;
  ULONG      Mode;
} KSDS3D_BUFFER_ALL, *PKSDS3D_BUFFER_ALL;

Члены

Position

Задает координаты положения x, y и z трехмерного звукового буфера. Этот элемент представляет собой структуру типа DS3DVECTOR.

Velocity

Задает компоненты скорости x, y и z трехмерного звукового буфера. Этот элемент представляет собой структуру типа DS3DVECTOR.

InsideConeAngle

Задает угол в градусах внутреннего конуса проекции звука.

OutsideConeAngle

Задает угол в градусах внешнего звукового конуса проекции.

ConeOrientation

Задает компоненты x, y и z ориентации звукового конуса трехмерного буфера. Этот элемент представляет собой структуру типа DS3DVECTOR.

ConeOutsideVolume

Указывает конус вне тома.

MinDistance

Указывает минимальное расстояние между динамиком и прослушивателем. (См. обсуждение минимальных и максимальных расстояний для буферов DirectSound 3D в документации по пакету SDK для Microsoft Windows.)

MaxDistance

Указывает максимальное расстояние между динамиком и прослушивателем.

Mode

Задает трехмерный режим обработки звука. Это может быть одно из следующих значений из файла заголовка Dsound.h:

  • DS3DMODE_DISABLE
  • DS3DMODE_HEADRELATIVE
  • DS3DMODE_NORMAL
Сведения о значении этих параметров см. в описании dwMode члена структуры DS3DBUFFER в документации по пакету SDK для Microsoft Windows.

Замечания

Эта структура используется для задания или получения значения данных для свойства KSPROPERTY_DIRECTSOUND3DBUFFER_ALL. DirectSound использует это свойство для реализации методов IDirectSound3DBuffer::GetAllParameters и IDirectSound3DBuffer::SetAllParameters, которые описаны в документации по пакету SDK для Windows.

Члены этой структуры похожи на те, которые определены для структуры DS3DBUFFER в документации по пакету SDK для Windows.

Требования

Требование Ценность
заголовка ksmedia.h (include Ksmedia.h)

См. также

DS3DVECTOR

KSPROPERTY_DIRECTSOUND3DBUFFER_ALL