KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR
Свойство KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR указывает коэффициент расстояния, который должен применяться к любым значениям расстояния.
Сводная таблица использования
| Получить | Присвойте параметру | Назначение | Тип дескриптора свойства | Тип значения свойства |
|---|---|---|---|---|
Да |
Да |
Pin |
FLOAT |
Значение свойства (данные операции) имеет тип FLOAT и указывает коэффициент расстояния.
Возвращаемое значение
Запрос свойства KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR возвращает STATUS_SUCCESS, чтобы указать, что он успешно завершен. В противном случае запрос возвращает соответствующий код состояния ошибки.
Комментарии
Расстояния для свойств KSPROPSETID_DirectSound3DBuffer и KSPROPSETID_DirectSound3DListener выражаются в единицах измерения на коэффициент расстояния.
По умолчанию коэффициент расстояния равен 1, поэтому расстояния выражаются в метрах. (Кроме того, единицами скорости по умолчанию являются метры в секунду.)
Клиент может изменить единицы расстояния для KSPROPSETID_DirectSound3DBuffer и KSPROPSETID_DirectSound3DListener свойств, отправив KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR запрос set-property, указывающий другой коэффициент расстояния.
DirectSound использует это свойство для реализации методов IDirectSound3DListener::GetDistanceFactor и IDirectSound3DListener::SetDistanceFactor, которые описаны в документации по Microsoft Windows SDK.
Требования
Заголовок |
Ksmedia.h (включая Ksmedia.h) |