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

KSPROPERTY_HRTF3D_INITIALIZE

KSPROPERTY_HRTF3D_PARAMS

Ein KSNODETYPE_3D_EFFECTS Knoten kann einen ITD-Algorithmus (Interaural Time Delay) implementieren. In diesem Fall sollte er die folgende optionale Eigenschaft unterstützen:

KSPROPERTY_ITD3D_PARAMS