Condividi tramite


struttura KSDS3D_HRTF_INIT_MSG (ksmedia.h)

La struttura KSDS3D_HRTF_INIT_MSG specifica le impostazioni dei parametri da usare per inizializzare la funzione di trasferimento head-relative (HRTF).

Sintassi

typedef struct {
  ULONG                      Size;
  KSDS3D_HRTF_FILTER_QUALITY Quality;
  FLOAT                      SampleRate;
  ULONG                      MaxFilterSize;
  ULONG                      FilterTransientMuteLength;
  ULONG                      FilterOverlapBufferLength;
  ULONG                      OutputOverlapBufferLength;
  ULONG                      Reserved;
} KSDS3D_HRTF_INIT_MSG, *PKSDS3D_HRTF_INIT_MSG;

Membri

Size

Specifica le dimensioni in byte della struttura.

Quality

Specifica il livello di qualità del filtro HRTF. Impostare questo parametro su uno dei valori di enumerazione KSDS3D_HRTF_FILTER_QUALITY seguenti:

  • LIGHT_FILTER seleziona un algoritmo efficiente che produce un buon effetto di qualità.
  • FULL_FILTER seleziona un algoritmo che produce un effetto di alta qualità, ma richiede più tempo di elaborazione.

SampleRate

Specifica la frequenza di campionamento, in campioni al secondo (hz), in cui ogni canale deve essere riprodotto. Ad esempio, un valore pari a 22.050 specifica una frequenza di campionamento di 22,05 kHz.

MaxFilterSize

Specifica la dimensione massima del filtro in byte. Se il filtro è in formato diretto, la dimensione massima è l'ordine del filtro (il numeratore e il denominatore hanno uguale ordine). Se il filtro è in formato a catena, la dimensione massima è il numero massimo di coefficienti biquadratici.

FilterTransientMuteLength

Specifica per quanto tempo ritardare la dissolvenza incrociata al nuovo filtro per evitare di introdurre il segnale temporaneo iniziale del nuovo filtro nel segnale di output. Il ritardo viene specificato come numero di campioni iniziali prodotti dal nuovo filtro. Durante questo periodo, l'output proviene solo dai filtri precedenti.

FilterOverlapBufferLength

Specifica il numero totale di campioni su cui disattivare e disattivare gli output del filtro.

OutputOverlapBufferLength

Specifica il numero di campioni su cui eseguire la dissolvenza incrociata dei canali di output dopo una transizione attraverso l'angolo azimuth zero. Questo membro viene utilizzato quando la dissolvenza incrociata dei canali di output è abilitata dal membro CrossFadeOutput di KSDS3D_HRTF_PARAMS_MSG.

Reserved

Riservato. Impostare su zero.

Osservazioni

Questa struttura viene utilizzata dalla proprietà KSPROPERTY_HRTF3D_INITIALIZE.

I valori di qualità FULL_FILTER e LIGHT_FILTER corrispondono alle impostazioni di GUID_DS3DALG_HRTF_FULL e GUID_DS3DALG_HRTF_LIGHT descritte nella documentazione di Microsoft Windows SDK.

Per altre informazioni, vedere KSPROPSETID_Hrtf3d.

Fabbisogno

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

Vedere anche

KSDS3D_HRTF_PARAMS_MSG

KSPROPERTY_HRTF3D_INITIALIZE

KSPROPSETID_Hrtf3d