KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR

A propriedade KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR especifica o fator de rolloff 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 rolloff. O fator de reversão pode variar de DS3D_MINROLLOFFFACTOR a DS3D_MAXROLLOFFFACTOR, que são definidos como 0,0 e 10,0, respectivamente. O fator de reversão padrão é DS3D_DEFAULTROLLOFFFACTOR, que é definido como 1.0.

Valor retornado

Uma solicitação de propriedade KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR 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

Rolloff é a quantidade de atenuação aplicada aos sons, com base na distância do ouvinte da fonte de som. Um fator de rolloff de zero significa que nenhuma atenuação é aplicada a um som, independentemente de sua distância do ouvinte. Fatores maiores que 1 exageram a atenuação real do som com distância.

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

Requisitos

parâmetro

Ksmedia.h (inclua Ksmedia.h)

Confira também

KSNODEPROPERTY