Partager via


KSNODETYPE_3D_EFFECTS

Le nœud KSNODETYPE_3D_EFFECTS représente un processeur d’effets 3D pour la couche d’accélération matérielle 3D spécifique à l’appareil qui sous-tend les API IDirectSound3DBuffer et IDirectSound3DListener (décrites dans la documentation Microsoft Windows SDK). Le nœud 3D a un flux d’entrée avec un ou deux canaux et un flux de sortie avec n canaux. Il positionne les canaux individuels du flux d’entrée dans le champ 3D-sound du flux de sortie.

Le flux d’entrée vers le nœud 3D contient généralement un seul canal. Dans DirectSound 8.0 et versions ultérieures, seules les mémoires tampons PCM mono peuvent être créées avec des effets 3D. Toutefois, les versions antérieures de DirectSound prennent en charge les nœuds 3D avec des flux d’entrée mono et stéréo, et les pilotes doivent les prendre en charge pour garantir la compatibilité avec les applications plus anciennes.

Le nœud KSNODETYPE_3D_EFFECTS permet de contrôler la configuration de l’orateur DirectSound via les propriétés facultatives suivantes :

KSPROPERTY_AUDIO_CHANNEL_CONFIG

KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY

Pour plus d’informations, consultez DirectSound Speaker-Configuration Settings.

En outre, DirectSound nécessite qu’un nœud KSNODETYPE_3D_EFFECTS prend en charge les propriétés 3D-listener et 3D-buffer suivantes :

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 nœud KSNODETYPE_3D_EFFECTS peut implémenter une fonction de transfert relative de la tête (HRTF), auquel cas il doit prendre en charge les propriétés facultatives suivantes :

KSPROPERTY_HRTF3D_FILTER_FORMAT

KSPROPERTY_HRTF3D_INITIALIZE

KSPROPERTY_HRTF3D_PARAMS

Un nœud KSNODETYPE_3D_EFFECTS peut implémenter un algorithme itd (interaural time delay), auquel cas il doit prendre en charge la propriété facultative suivante :

KSPROPERTY_ITD3D_PARAMS