KSDS3D_HRTF_INIT_MSG Struktur (ksmedia.h)
Die KSDS3D_HRTF_INIT_MSG Struktur gibt die Parametereinstellungen an, die zum Initialisieren der Head-relative Transfer-Funktion (HRTF) verwendet werden sollen.
Syntax
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;
Angehörige
Size
Gibt die Größe in Byte der Struktur an.
Quality
Gibt die HRTF-Filterqualitätsstufe an. Legen Sie diesen Parameter auf einen der folgenden KSDS3D_HRTF_FILTER_QUALITY Enumerationswerte fest:
- LIGHT_FILTER wählt einen effizienten Algorithmus aus, der einen guten Qualitätseffekt erzeugt.
- FULL_FILTER wählt einen Algorithmus aus, der einen qualitativ hochwertigen Effekt erzeugt, aber mehr Verarbeitungszeit erfordert.
SampleRate
Gibt die Samplingrate in Stichproben pro Sekunde (Hertz) an, bei der jeder Kanal wiedergegeben werden soll. Beispielsweise gibt ein Wert von 22.050 eine Stichprobenrate von 22,05 kHz an.
MaxFilterSize
Gibt die maximale Filtergröße in Bytes an. Wenn sich der Filter in direkter Form befindet, ist die maximale Größe die Reihenfolge des Filters (Zähler und Nenner haben die gleiche Reihenfolge). Wenn sich der Filter in Kaskadenform befindet, ist die maximale Größe die maximale Anzahl biquadratischer Koeffizienten.
FilterTransientMuteLength
Gibt an, wie lange das Querblenden auf den neuen Filter verzögert werden soll, um zu vermeiden, dass das anfängliche vorübergehende Signal des neuen Filters in das Ausgabesignal eingeführt wird. Die Verzögerung wird als eine Reihe von Anfangsproben angegeben, die vom neuen Filter erzeugt werden. Während dieser Zeit stammt die Ausgabe nur aus den alten Filtern.
FilterOverlapBufferLength
Gibt die Gesamtanzahl der Beispiele an, über die die Filterausgabe stummgeschaltet und ausgeblendet werden soll.
OutputOverlapBufferLength
Gibt die Anzahl der Beispiele an, über die die Ausgabekanäle nach einem Übergang über den Azimut-Winkel null durchgeblendet werden sollen. Dieses Element wird verwendet, wenn das Querblenden der Ausgabekanäle durch das CrossFadeOutput- Mitglied von KSDS3D_HRTF_PARAMS_MSGaktiviert wird.
Reserved
Reserviert. Auf Null festgelegt.
Bemerkungen
Diese Struktur wird von der KSPROPERTY_HRTF3D_INITIALIZE-Eigenschaft verwendet.
Die werte Quality FULL_FILTER und LIGHT_FILTER entsprechen den in der Microsoft Windows SDK-Dokumentation beschriebenen einstellungen GUID_DS3DALG_HRTF_FULL und GUID_DS3DALG_HRTF_LIGHT.
Weitere Informationen finden Sie unter KSPROPSETID_Hrtf3d.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | ksmedia.h (enthalten Ksmedia.h) |