structure KSDS3D_HRTF_INIT_MSG (ksmedia.h)
La structure KSDS3D_HRTF_INIT_MSG spécifie les paramètres à utiliser pour initialiser la fonction de transfert relative à la tête (HRTF).
Syntaxe
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;
Membres
Size
Spécifie la taille en octets de la structure.
Quality
Spécifie le niveau de qualité du filtre HRTF. Définissez ce paramètre sur l’une des valeurs d’énumération KSDS3D_HRTF_FILTER_QUALITY suivantes :
- LIGHT_FILTER sélectionne un algorithme efficace qui produit un effet de bonne qualité.
- FULL_FILTER sélectionne un algorithme qui produit un effet de haute qualité, mais qui nécessite plus de temps de traitement.
SampleRate
Spécifie la fréquence d’échantillonnage, en échantillons par seconde (hertz), à laquelle chaque canal doit être lu. Par exemple, une valeur de 22 050 spécifie une fréquence d’échantillonnage de 22,05 kHz.
MaxFilterSize
Spécifie la taille maximale du filtre en octets. Si le filtre est sous forme directe, la taille maximale est l’ordre du filtre (numérateur et dénominateur ont un ordre égal). Si le filtre est sous forme de cascade, la taille maximale est le nombre maximal de coefficients biquadratiques.
FilterTransientMuteLength
Spécifie la durée pendant laquelle retarder la décoloration croisée vers le nouveau filtre afin d’éviter d’introduire le signal temporaire initial du nouveau filtre dans le signal de sortie. Le délai est spécifié sous la forme d’un certain nombre d’exemples initiaux produits par le nouveau filtre. Pendant ce temps, la sortie provient uniquement des anciens filtres.
FilterOverlapBufferLength
Spécifie le nombre total d’exemples sur lesquels désactiver le son et le fondu croisé des sorties de filtre.
OutputOverlapBufferLength
Spécifie le nombre d’échantillons sur lesquels effectuer un fondu croisé des canaux de sortie après une transition entre l’angle d’azimut zéro. Ce membre est utilisé lorsque le décoloration croisée des canaux de sortie est activé par le membre CrossFadeOutput de KSDS3D_HRTF_PARAMS_MSG.
Reserved
Réservé. Définit la valeur zéro.
Remarques
Cette structure est utilisée par la propriété KSPROPERTY_HRTF3D_INITIALIZE .
Les valeurs qualité FULL_FILTER et LIGHT_FILTER correspondent aux paramètres de GUID_DS3DALG_HRTF_FULL et de GUID_DS3DALG_HRTF_LIGHT décrits dans la documentation Microsoft Windows SDK.
Pour plus d’informations, consultez KSPROPSETID_Hrtf3d.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | ksmedia.h (inclure Ksmedia.h) |