Compartilhar via


KSNODETYPE_3D_EFFECTS

O nó KSNODETYPE_3D_EFFECTS representa um processador de efeitos 3D para as APIs 3D HAL (camada de aceleração de hardware) específicas do dispositivo subjacentes às APIs IDirectSound3DBuffer e IDirectSound3DListener (descritas na documentação do SDK do Microsoft Windows). O nó 3D tem um fluxo de entrada com um ou dois canais e um fluxo de saída com n canais. Ele posiciona os canais individuais do fluxo de entrada dentro do campo de som 3D do fluxo de saída.

O fluxo de entrada para o nó 3D normalmente contém um único canal. No DirectSound 8.0 e posterior, somente buffers PCM mono podem ser criados com efeitos 3D. No entanto, as versões anteriores do DirectSound dão suporte a nós 3D com fluxos de entrada mono e estéreo, e os drivers devem dar suporte a ambos para garantir a compatibilidade com aplicativos mais antigos.

O nó KSNODETYPE_3D_EFFECTS é usado para controlar a configuração do alto-falante DirectSound por meio das seguintes propriedades opcionais:

KSPROPERTY_AUDIO_CHANNEL_CONFIG

KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY

Para obter mais informações, consulte Configurações de Speaker-Configuration do DirectSound.

Além disso, o DirectSound requer que um nó KSNODETYPE_3D_EFFECTS dê suporte às seguintes propriedades de ouvinte 3D e 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

Um nó KSNODETYPE_3D_EFFECTS pode implementar uma HRTF (função de transferência relativa à cabeça), nesse caso, ele deve dar suporte às seguintes propriedades opcionais:

KSPROPERTY_HRTF3D_FILTER_FORMAT

KSPROPERTY_HRTF3D_INITIALIZE

KSPROPERTY_HRTF3D_PARAMS

Um nó KSNODETYPE_3D_EFFECTS pode implementar um algoritmo de ITD (atraso de tempo interaural), nesse caso, ele deve dar suporte à seguinte propriedade opcional:

KSPROPERTY_ITD3D_PARAMS