KSDS3D_BUFFER_ALL structure (ksmedia.h)

  • Article

La structure KSDS3D_BUFFER_ALL spécifie toutes les caractéristiques 3D d’une mémoire tampon DirectSound 3D.

Syntaxe

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;

Membres

Position

Spécifie les coordonnées de position x, y et z de la mémoire tampon audio 3D. Ce membre est une structure de type DS3DVECTOR.

Velocity

Spécifie les composants de vitesse x, y et z de la mémoire tampon sonore 3D. Ce membre est une structure de type DS3DVECTOR.

InsideConeAngle

Spécifie l’angle en degrés du cône de projection sonore intérieur.

OutsideConeAngle

Spécifie l’angle en degrés du cône de projection sonore extérieur.

ConeOrientation

Spécifie les composants x, y et z de l’orientation du cône de projection sonore de la mémoire tampon 3D. Ce membre est une structure de type DS3DVECTOR.

ConeOutsideVolume

Spécifie le cône en dehors du volume.

MinDistance

Spécifie la distance minimale entre l’orateur et l’écouteur. (Consultez la présentation des distances minimales et maximales pour les mémoires tampons DirectSound 3D dans la documentation Microsoft Windows SDK.)

MaxDistance

Spécifie la distance maximale entre l’orateur et l’écouteur.

Mode

Spécifie le mode de traitement du son 3D. Il peut s’agir de l’une des valeurs suivantes du fichier d’en-tête Dsound.h :

  • DS3DMODE_DISABLE
  • DS3DMODE_HEADRELATIVE
  • DS3DMODE_NORMAL
Pour connaître la signification de ces paramètres, consultez la description du membre dwMode de la structure DS3DBUFFER dans la documentation Microsoft Windows SDK.

Remarques

Cette structure est utilisée pour définir ou obtenir la valeur de données de la propriété KSPROPERTY_DIRECTSOUND3DBUFFER_ALL . DirectSound utilise cette propriété pour implémenter les méthodes IDirectSound3DBuffer ::GetAllParameters et IDirectSound3DBuffer ::SetAllParameters , qui sont décrites dans la documentation du SDK Windows.

Les membres de cette structure sont similaires à ceux définis pour la structure DS3DBUFFER dans la documentation du SDK Windows.

Configuration requise

Condition requise Valeur
En-tête ksmedia.h (incluez Ksmedia.h)

Voir aussi

DS3DVECTOR

KSPROPERTY_DIRECTSOUND3DBUFFER_ALL