KSDS3D_HRTF_INIT_MSG-Struktur (ksmedia.h)
Die KSDS3D_HRTF_INIT_MSG-Struktur gibt die Parametereinstellungen an, die verwendet werden sollen, um die Head-Relative Transfer-Funktion (HRTF) zu initialisieren.
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;
Member
Size
Gibt die Größe der -Struktur in Byte an.
Quality
Gibt die Qualitätsebene des HRTF-Filters 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 Abtastrate in Stichproben pro Sekunde (Hertz) an, mit der jeder Kanal wiedergegeben werden soll. Beispielsweise gibt der Wert 22.050 eine Abtastrate von 22,05 kHz an.
MaxFilterSize
Gibt die maximale Filtergröße in Byte an. Wenn der Filter in direkter Form vorliegt, entspricht die maximale Größe der Reihenfolge des Filters (Zähler und Nenner haben die gleiche Reihenfolge). Wenn der Filter kaskadiert ist, ist die maximale Größe die maximale Anzahl biquadratischer Koeffizienten.
FilterTransientMuteLength
Gibt an, wie lange das Crossfading zum neuen Filter verzögert werden soll, um zu vermeiden, dass das anfängliche vorübergehende Signal des neuen Filters in das Ausgabesignal eingefügt wird. Die Verzögerung wird als Anzahl von anfangs vom neuen Filter erzeugten Stichproben angegeben. Während dieser Zeit stammt die Ausgabe nur aus den alten Filtern.
FilterOverlapBufferLength
Gibt die Gesamtzahl der Stichproben an, über die die Filterausgaben stummgeschaltet und ausgeblendet werden sollen.
OutputOverlapBufferLength
Gibt die Anzahl der Stichproben an, über die die Ausgabekanäle nach einem Übergang über den Azimutwinkel 0 (Null) ausgeblendet werden sollen. Dieser Member wird verwendet, wenn das Crossfading der Ausgabekanäle vom CrossFadeOutput-Member von KSDS3D_HRTF_PARAMS_MSG aktiviert wird.
Reserved
Reserviert. Auf NULL festlegen.
Hinweise
Diese Struktur wird von der KSPROPERTY_HRTF3D_INITIALIZE-Eigenschaft verwendet.
Die Qualitätswerte FULL_FILTER und LIGHT_FILTER entsprechen den in der Microsoft Windows SDK-Dokumentation beschriebenen GUID_DS3DALG_HRTF_FULL- und GUID_DS3DALG_HRTF_LIGHT-Einstellungen.
Weitere Informationen finden Sie unter KSPROPSETID_Hrtf3d.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | ksmedia.h (include Ksmedia.h) |