KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR
A propriedade KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR especifica o fator de distância que deve ser aplicado a quaisquer valores de distância.
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 de distância.
Valor retornado
Uma solicitação de propriedade KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR 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
As distâncias das propriedades KSPROPSETID_DirectSound3DBuffer e KSPROPSETID_DirectSound3DListener são expressas em unidades de metros vezes um fator de distância.
Por padrão, o fator de distância é 1 e, portanto, as distâncias são expressas em metros. (Além disso, as unidades de velocidade padrão são metros por segundo.)
Um cliente pode alterar as unidades de distância para as propriedades KSPROPSETID_DirectSound3DBuffer e KSPROPSETID_DirectSound3DListener enviando um KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR solicitação set-property que especifica um fator de distância diferente.
O DirectSound usa essa propriedade para implementar os métodos IDirectSound3DListener::GetDistanceFactor e IDirectSound3DListener::SetDistanceFactor, descritos na documentação do SDK do Microsoft Windows.
Requisitos
parâmetro |
Ksmedia.h (inclua Ksmedia.h) |