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 |
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) |