Compartilhar via


KSPROPERTY_DIRECTSOUND3DLISTENER_DOPPLERFACTOR

A propriedade KSPROPERTY_DIRECTSOUND3DLISTENER_DOPPLERFACTOR especifica o fator Doppler para um ouvinte 3D.

Tabela de Resumo de Uso

Obter Definir Destino Tipo de descritor de propriedade Tipo de valor da propriedade

Sim

Sim

Pin

KSNODEPROPERTY

FLOAT

O valor da propriedade (dados de operação) é do tipo FLOAT e especifica o fator Doppler. O fator Doppler pode variar de DS3D_MINDOPPLERFACTOR a DS3D_MAXDOPPLERFACTOR, que são definidos como 0,0 e 10,0, respectivamente. O fator padrão é DS3D_DEFAULTDOPPLERFACTOR, que é definido como 1.0.

Valor retornado

Uma solicitação de propriedade KSPROPERTY_DIRECTSOUND3DLISTENER_DOPPLERFACTOR retorna STATUS_SUCCESS para indicar que foi concluída com êxito. Caso contrário, a solicitação retornará um erro apropriado status código.

Comentários

Essa propriedade especifica o fator Doppler aplicado ao ouvinte 3D e ao buffer de som 3D.

Um fator Doppler de zero significa que nenhuma mudança do Doppler é aplicada a um som, independentemente da velocidade do ouvinte ou do buffer de som. Fatores maiores que 1 exageram a quantidade de mudança de Doppler que ocorreria no mundo real.

O DirectSound usa essa propriedade para implementar os métodos IDirectSound3DListener::GetDopplerFactor e IDirectSound3DListener::SetDopplerFactor, descritos na documentação do SDK do Microsoft Windows.

Requisitos

parâmetro

Ksmedia.h (inclua Ksmedia.h)

Confira também

KSNODEPROPERTY