KSDS3D_BUFFER_ALL-Struktur (ksmedia.h)

Artikel
02/26/2024

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. Dieser Member ist eine Struktur vom Typ DS3DVECTOR.

Velocity

Gibt die Geschwindigkeitskomponenten x, y und z des 3D-Soundpuffers an. Dieser Member ist eine Struktur vom Typ DS3DVECTOR.

InsideConeAngle

Gibt den Winkel in Grad des inneren Schallprojektionskegels an.

OutsideConeAngle

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

ConeOrientation

Gibt die x-, y- und z-Komponenten der Ausrichtung des Soundprojektionskegels des 3D-Puffers an. Dieser Member ist eine Struktur vom Typ DS3DVECTOR.

ConeOutsideVolume

Gibt den Kegel außerhalb des Volumes an.

MinDistance

Gibt den Mindestabstand zwischen Sprecher und Hörer an. (Weitere Informationen zu minimalen und maximalen Abständen für DirectSound 3D-Puffer finden Sie in der Microsoft Windows SDK-Dokumentation.)

MaxDistance

Gibt den maximalen Abstand zwischen Sprecher und Listener an.

Mode

Gibt den 3D-Soundverarbeitungsmodus an. Dies kann einer 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-Elements der DS3DBUFFER-Struktur in der Microsoft Windows SDK-Dokumentation.

Hinweise

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.

Anforderungen

Anforderung	Wert
Header	ksmedia.h (include Ksmedia.h)

Weitere Informationen

DS3DVECTOR

KSPROPERTY_DIRECTSOUND3DBUFFER_ALL

Freigeben über