Condividi tramite

KSNODETYPE_3D_EFFECTS

  • Articolo

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

KSPROPERTY_HRTF3D_INITIALIZE

KSPROPERTY_HRTF3D_PARAMS

Un nodo KSNODETYPE_3D_EFFECTS potrebbe implementare un algoritmo di ritardo del tempo interaurale (ITD), nel qual caso deve supportare la proprietà facoltativa seguente:

KSPROPERTY_ITD3D_PARAMS