Поделиться через

KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR

  • Статья

Свойство KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR указывает коэффициент отката для трехмерного прослушивателя.

Сводная таблица использования

Получить Присвойте параметру Назначение Тип дескриптора свойства Тип значения свойства

Да

Да

Pin

KSNODEPROPERTY

FLOAT

Значение свойства (данные операции) имеет тип FLOAT и указывает коэффициент отката. Коэффициент выпуска может варьироваться от DS3D_MINROLLOFFFACTOR до DS3D_MAXROLLOFFFACTOR, которые определяются как 0,0 и 10,0 соответственно. Коэффициент выпуска по умолчанию — DS3D_DEFAULTROLLOFFFACTOR, который определяется как 1.0.

Возвращаемое значение

Запрос свойства KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR возвращает STATUS_SUCCESS, указывающий на успешное выполнение. В противном случае запрос возвращает соответствующий код состояния ошибки.

Комментарии

Rolloff — это величина затухания, применяемая к звукам, в зависимости от расстояния прослушивателя от источника звука. Коэффициент отката, равный нулю, означает, что к звуку не применяется затухание независимо от его расстояния от прослушивателя. Факторы, превышающие 1, преувеличивают реальное затухание звука с расстоянием.

DirectSound использует это свойство для реализации методов IDirectSound3DListener::GetRolloffFactor и IDirectSound3DListener::SetRolloffFactor, которые описаны в документации по Microsoft Windows SDK.

Требования

Заголовок

 Ksmedia.h (включая Ksmedia.h)

См. также

KSNODEPROPERTY