struttura KSDS3D_BUFFER_ALL (ksmedia.h)

Articolo
02/07/2025

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;

Membri

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 velocity del buffer audio 3D. Questo membro è una struttura di tipo DS3DVECTOR.

InsideConeAngle

Specifica l'angolo in gradi del cono di proiezione audio interna.

OutsideConeAngle

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

ConeOrientation

Specifica i componenti x, y e z dell'orientamento del cono di proiezione 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. Può trattarsi di uno dei valori seguenti del file di intestazione Dsound.h:

DS3DMODE_DISABLE
DS3DMODE_HEADRELATIVE
DS3DMODE_NORMAL

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

Osservazioni

Questa struttura viene utilizzata per impostare o ottenere il valore dei dati per la proprietà KSPROPERTY_DIRECTSOUND3DBUFFER_ALL. DirectSound usa questa proprietà per implementare i metodi di 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.

Fabbisogno

Requisito	Valore
intestazione	ksmedia.h (include Ksmedia.h)

Vedere anche

DS3DVECTOR

KSPROPERTY_DIRECTSOUND3DBUFFER_ALL

Condividi tramite