KSDS3D_BUFFER_ALL Struktur (ksmedia.h)

Die KSDS3D_BUFFER_ALL Struktur gibt alle 3D-Merkmale eines DirectSound 3D-Puffers an.

Syntax

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;

Member

Position

Gibt die X-, Y- und Z-Positionskoordinaten des 3D-Soundpuffers an. Dieses Element ist eine Struktur des Typs DS3DVECTOR.

Velocity

Gibt die x-, y- und z-Geschwindigkeitskomponenten des 3D-Soundpuffers an. Dieses Element ist eine Struktur des Typs DS3DVECTOR.

InsideConeAngle

Gibt den Winkel in Grad des inneren Soundprojektionskegels an.

OutsideConeAngle

Gibt den Winkel in Grad des äußeren Soundprojektionskegels an.

ConeOrientation

Gibt die x-, y- und z-Komponenten der Ausrichtung des Soundprojektionskongels des 3D-Puffers an. Dieses Element ist eine Struktur des Typs DS3DVECTOR.

ConeOutsideVolume

Gibt den Kegel außerhalb des Volumens an.

MinDistance

Gibt den Mindestabstand zwischen dem Lautsprecher und dem Listener an. (Lesen Sie die Diskussion über mindest- und maximal zulässige Abstände für DirectSound 3D-Puffer in der Microsoft Windows SDK Dokumentation.)

MaxDistance

Gibt den maximalen Abstand zwischen dem Lautsprecher und dem Listener an.

Mode

Gibt den 3D-Soundverarbeitungsmodus an. Dies kann eine der folgenden Werte aus der Headerdatei Dsound.h sein:

  • DS3DMODE_DISABLE
  • DS3DMODE_HEADRELATIVE
  • DS3DMODE_NORMAL
Die Bedeutung dieser Parameter finden Sie in der Beschreibung des dwMode-Members der DS3DBUFFER-Struktur in der Microsoft Windows SDK Dokumentation.

Bemerkungen

Diese Struktur wird verwendet, um den Datenwert für die KSPROPERTY_DIRECTSOUND3DBUFFER_ALL-Eigenschaft festzulegen oder abzurufen. DirectSound verwendet diese Eigenschaft, um die Methoden IDirectSound3DBuffer::GetAllParameters und IDirectSound3DBuffer::SetAllParameters zu implementieren, die in der Windows SDK-Dokumentation beschrieben werden.

Die Member dieser Struktur ähneln denen, die für die DS3DBUFFER-Struktur in der Windows SDK-Dokumentation definiert sind.

Requirements (Anforderungen)

   
Header ksmedia.h (include Ksmedia.h)

Weitere Informationen

DS3DVECTOR

KSPROPERTY_DIRECTSOUND3DBUFFER_ALL