estructura KSDS3D_BUFFER_ALL (ksmedia.h)

  • Artículo

La estructura KSDS3D_BUFFER_ALL especifica todas las características 3D de un búfer 3D de DirectSound.

Sintaxis

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;

Miembros

Position

Especifica las coordenadas de posición x, y y z del búfer de sonido 3D. Este miembro es una estructura de tipo DS3DVECTOR.

Velocity

Especifica los componentes de velocidad x, y y z del búfer de sonido 3D. Este miembro es una estructura de tipo DS3DVECTOR.

InsideConeAngle

Especifica el ángulo en grados del cono de proyección de sonido interior.

OutsideConeAngle

Especifica el ángulo en grados del cono de proyección de sonido exterior.

ConeOrientation

Especifica los componentes x, y y z de la orientación del cono de proyección de sonido del búfer 3D. Este miembro es una estructura de tipo DS3DVECTOR.

ConeOutsideVolume

Especifica el cono fuera del volumen.

MinDistance

Especifica la distancia mínima entre el altavoz y el agente de escucha. (Consulte la explicación de las distancias mínimas y máximas para los búferes 3D de DirectSound en la documentación de Microsoft Windows SDK).

MaxDistance

Especifica la distancia máxima entre el altavoz y el agente de escucha.

Mode

Especifica el modo de procesamiento de sonido 3D. Puede ser uno de los siguientes valores del archivo de encabezado Dsound.h:

  • DS3DMODE_DISABLE
  • DS3DMODE_HEADRELATIVE
  • DS3DMODE_NORMAL
Para obtener el significado de estos parámetros, consulte la descripción del miembro dwMode de la estructura DS3DBUFFER en la documentación de Microsoft Windows SDK.

Comentarios

Esta estructura se usa para establecer u obtener el valor de datos de la propiedad KSPROPERTY_DIRECTSOUND3DBUFFER_ALL . DirectSound usa esta propiedad para implementar los métodos IDirectSound3DBuffer::GetAllParameters e IDirectSound3DBuffer::SetAllParameters , que se describen en la documentación de Windows SDK.

Los miembros de esta estructura son similares a los definidos para la estructura de DS3DBUFFER en la documentación de Windows SDK.

Requisitos

Requisito Valor
Header ksmedia.h (incluye Ksmedia.h)

Consulte también

DS3DVECTOR

KSPROPERTY_DIRECTSOUND3DBUFFER_ALL