KSDS3D_HRTF_INIT_MSG struttura (ksmedia.h)

Articolo
02/29/2024

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;

Members

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 seguenti KSDS3D_HRTF_FILTER_QUALITY:

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, nei campioni al secondo (hertz), in cui ogni canale deve essere riprodotto. Ad esempio, un valore pari a 22.050 specifica una frequenza di esempio pari a 22,05 kHz.

MaxFilterSize

Specifica le dimensioni massime del filtro in byte. Se il filtro è in forma diretta, la dimensione massima è l'ordine del filtro (numeratore e denominatore hanno un ordine uguale). Se il filtro è in forma a cascata, la dimensione massima è il numero massimo di coefficienti biquadratici.

FilterTransientMuteLength

Specifica quanto tempo ritardare la sbiadimento incrociato del nuovo filtro per evitare di introdurre il segnale temporaneo iniziale del nuovo filtro nel segnale di output. Il ritardo viene specificato come numero di esempi 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 sfondare gli output del filtro.

OutputOverlapBufferLength

Specifica il numero di campioni su cui scorrere i canali di output dopo una transizione tra angoli azimuth zero. Questo membro viene usato quando il passaggio incrociato dei canali di output è abilitato dal membro CrossFadeOutput di KSDS3D_HRTF_PARAMS_MSG.

Reserved

Riservato. Imposta su zero.

Commenti

Questa struttura viene usata dalla proprietà KSPROPERTY_HRTF3D_INITIALIZE .

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

Per altre informazioni, vedere KSPROPSETID_Hrtf3d.