KSNODETYPE_3D_EFFECTS
Der knoten KSNODETYPE_3D_EFFECTS stellt einen 3D-Effektprozessor für die gerätespezifische 3D HAL (Hardwarebeschleunigungsebene) dar, die den IDirectSound3DBuffer- und IDirectSound3DListener-APIs zugrunde steht (siehe Microsoft Windows SDK Dokumentation). Der 3D-Knoten verfügt über einen Eingabestream mit einem oder zwei Kanälen und einen Ausgabestream mit n Kanälen. Es positioniert die einzelnen Kanäle des Eingabestreams innerhalb des 3D-Soundfelds des Ausgabestreams.
Der Eingabedatenstrom zum 3D-Knoten enthält in der Regel einen einzelnen Kanal. In DirectSound 8.0 und höher können nur Mono-PCM-Puffer mit 3D-Effekten erstellt werden. Frühere Versionen von DirectSound unterstützen jedoch 3D-Knoten mit Mono- und Stereo-Eingabestreams, und Treiber sollten beide unterstützen, um die Kompatibilität mit älteren Anwendungen sicherzustellen.
Der knoten KSNODETYPE_3D_EFFECTS wird verwendet, um die DirectSound-Lautsprecherkonfiguration über die folgenden optionalen Eigenschaften zu steuern:
KSPROPERTY_AUDIO_CHANNEL_CONFIG
KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY
Weitere Informationen finden Sie unter DirectSound Speaker-Configuration Einstellungen.
Darüber hinaus erfordert DirectSound, dass ein KSNODETYPE_3D_EFFECTS Knoten die folgenden 3D-Listener- und 3D-Puffereigenschaften unterstützt:
KSPROPERTY_DIRECTSOUND3DBUFFER_ALL
KSPROPERTY_DIRECTSOUND3DBUFFER_POSITION
KSPROPERTY_DIRECTSOUND3DBUFFER_VELOCITY
KSPROPERTY_DIRECTSOUND3DBUFFER_CONEANGLES
KSPROPERTY_DIRECTSOUND3DBUFFER_CONEORIENTATION
KSPROPERTY_DIRECTSOUND3DBUFFER_CONEOUTSIDEVOLUME
KSPROPERTY_DIRECTSOUND3DBUFFER_MINDISTANCE
KSPROPERTY_DIRECTSOUND3DBUFFER_MAXDISTANCE
KSPROPERTY_DIRECTSOUND3DBUFFER_MODE
KSPROPERTY_DIRECTSOUND3DLISTENER_ALL
KSPROPERTY_DIRECTSOUND3DLISTENER_POSITION
KSPROPERTY_DIRECTSOUND3DLISTENER_VELOCITY
KSPROPERTY_DIRECTSOUND3DLISTENER_ORIENTATION
KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR
KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR
KSPROPERTY_DIRECTSOUND3DLISTENER_DOPPLERFACTOR
KSPROPERTY_DIRECTSOUND3DLISTENER_BATCH
Ein KSNODETYPE_3D_EFFECTS Knoten kann eine Head-Relative Transfer Function (HRTF) implementieren. In diesem Fall sollte er die folgenden optionalen Eigenschaften unterstützen:
KSPROPERTY_HRTF3D_FILTER_FORMAT
Ein KSNODETYPE_3D_EFFECTS Knoten kann einen ITD-Algorithmus (Interaural Time Delay) implementieren. In diesem Fall sollte er die folgende optionale Eigenschaft unterstützen: