KSNODETYPE_3D_EFFECTS
Il nodo KSNODETYPE_3D_EFFECTS rappresenta un processore di effetti 3D per il livello di accelerazione hardware (3D HAL) specifico del dispositivo che sottoscriva le API IDirectSound3DBuffer e IDirectSound3DListener (descritte nella documentazione di Microsoft Windows SDK). Il nodo 3D ha un flusso di input con uno o due canali e un flusso di output con n canali. Posiziona i singoli canali del flusso di input all'interno del campo audio 3D del flusso di output.
Il flusso di input al nodo 3D contiene in genere un singolo canale. In DirectSound 8.0 e versioni successive è possibile creare solo buffer PCM mono con effetti 3D. Le versioni precedenti di DirectSound, tuttavia, supportano nodi 3D con flussi di input mono e stereo e i driver devono supportare entrambi per garantire la compatibilità con le applicazioni precedenti.
Il nodo KSNODETYPE_3D_EFFECTS viene usato per controllare la configurazione dell'altoparlante DirectSound tramite le proprietà facoltative seguenti:
KSPROPERTY_AUDIO_CHANNEL_CONFIG
KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY
Per altre informazioni, vedere Impostazioni Speaker-Configuration DirectSound.
DirectSound richiede inoltre che un nodo KSNODETYPE_3D_EFFECTS supporti le proprietà seguenti del listener 3D e del buffer 3D:
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
Un nodo KSNODETYPE_3D_EFFECTS potrebbe implementare una funzione di trasferimento head-relative (HRTF), nel qual caso deve supportare le proprietà facoltative seguenti:
KSPROPERTY_HRTF3D_FILTER_FORMAT
Un nodo KSNODETYPE_3D_EFFECTS potrebbe implementare un algoritmo di ritardo del tempo interaurale (ITD), nel qual caso deve supportare la proprietà facoltativa seguente: