KSDS3D_BUFFER_ALL struttura (ksmedia.h)

La struttura KSDS3D_BUFFER_ALL specifica tutte le caratteristiche 3D di un buffer DirectSound 3D.

Sintassi

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;

Members

Position

Specifica le coordinate di posizione x, y e z del buffer audio 3D. Questo membro è una struttura di tipo DS3DVECTOR.

Velocity

Specifica i componenti x, y e z velocità del buffer audio 3D. Questo membro è una struttura di tipo DS3DVECTOR.

InsideConeAngle

Specifica l'angolo in gradi del cono di proiezione sonora all'interno.

OutsideConeAngle

Specifica l'angolo in gradi del cono di proiezione sonora esterna.

ConeOrientation

Specifica i componenti x, y e z dell'orientamento del cono audio del buffer 3D. Questo membro è una struttura di tipo DS3DVECTOR.

ConeOutsideVolume

Specifica il cono esterno al volume.

MinDistance

Specifica la distanza minima tra l'altoparlante e il listener. Vedere la discussione sulle distanze minime e massime per i buffer DirectSound 3D nella documentazione di Microsoft Windows SDK.

MaxDistance

Specifica la distanza massima tra l'altoparlante e il listener.

Mode

Specifica la modalità di elaborazione audio 3D. Questo può essere uno dei valori seguenti dal file di intestazione Dsound.h:

  • DS3DMODE_DISABLE
  • DS3DMODE_HEADRELATIVE
  • DS3DMODE_NORMAL
Per il significato di questi parametri, vedere la descrizione del membro dwMode della struttura DS3DBUFFER nella documentazione di Microsoft Windows SDK.

Commenti

Questa struttura viene usata per impostare o ottenere il valore dei dati per la proprietà KSPROPERTY_DIRECTSOUND3DBUFFER_ALL . DirectSound usa questa proprietà per implementare i metodi IDirectSound3DBuffer::GetAllParameters e IDirectSound3DBuffer::SetAllParameters, descritti nella documentazione di Windows SDK.

I membri di questa struttura sono simili a quelli definiti per la struttura DS3DBUFFER nella documentazione di Windows SDK.

Requisiti

Requisito Valore
Intestazione ksmedia.h (includere Ksmedia.h)

Vedi anche

DS3DVECTOR

KSPROPERTY_DIRECTSOUND3DBUFFER_ALL