structure KSDS3D_BUFFER_ALL (ksmedia.h)

Article
02/07/2025

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 sonore 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 à l’intérieur.

OutsideConeAngle

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

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 discussion sur les distances minimales et maximales pour les mémoires tampons DirectSound 3D dans la documentation du Kit de développement logiciel (SDK) Microsoft Windows.)

MaxDistance

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

Mode

Spécifie le mode de traitement audio 3D. Il peut s’agir de l’une des valeurs suivantes à partir 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 du Kit de développement logiciel (SDK) Microsoft Windows.

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 méthodes, qui sont décrites dans la documentation du Kit de développement logiciel (SDK) Windows.

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

Exigences

Exigence	Valeur
d’en-tête	ksmedia.h (include Ksmedia.h)

Voir aussi

DS3DVECTOR

KSPROPERTY_DIRECTSOUND3DBUFFER_ALL

Partager via