The KSNODETYPE_3D_EFFECTS node represents a 3D-effects processor for the device-specific 3D HAL (hardware acceleration layer) that underlies the IDirectSound3DBuffer and IDirectSound3DListener APIs (described in the Microsoft Windows SDK documentation). The 3D node has one input stream with either one or two channels and one output stream with n channels. It positions the individual channels of the input stream within the 3D-sound field of the output stream.
The input stream to the 3D node typically contains a single channel. In DirectSound 8.0 and later, only mono PCM buffers can be created with 3D effects. Earlier versions of DirectSound, however, support 3D nodes with both mono and stereo input streams, and drivers should support both in order to ensure compatibility with older applications.
The KSNODETYPE_3D_EFFECTS node is used to control the DirectSound speaker configuration through the following optional properties:
For more information, see DirectSound Speaker-Configuration Settings.
In addition, DirectSound requires that a KSNODETYPE_3D_EFFECTS node support the following 3D-listener and 3D-buffer properties:
A KSNODETYPE_3D_EFFECTS node might implement a head-relative transfer function (HRTF), in which case it should support the following optional properties:
A KSNODETYPE_3D_EFFECTS node might implement an interaural time delay (ITD) algorithm, in which case it should support the following optional property: