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

  • Статья

Структура KSDS3D_BUFFER_ALL определяет все трехмерные характеристики трехмерного буфера DirectSound.

Синтаксис

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 в документации по Microsoft Windows SDK.)

MaxDistance

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

Mode

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

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

Комментарии

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

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

Требования

Требование Значение
Заголовок ksmedia.h (включая Ksmedia.h)

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

DS3DVECTOR

KSPROPERTY_DIRECTSOUND3DBUFFER_ALL