structure KSDS3D_HRTF_INIT_MSG (ksmedia.h)

  • Article

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)

Voir aussi

KSDS3D_HRTF_PARAMS_MSG

KSPROPERTY_HRTF3D_INITIALIZE

KSPROPSETID_Hrtf3d