KSDS3D_HRTF_INIT_MSG struttura (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;
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.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | ksmedia.h (includere Ksmedia.h) |