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

KSPROPERTY_DIRECTSOUND3DLISTENER_DOPPLERFACTOR

  • Статья

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

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

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

Да

Да

Pin

KSNODEPROPERTY

FLOAT

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

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

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

Комментарии

Это свойство задает допплер-фактор, применяемый как к прослушивателю 3D, так и к буферу трехмерного звука.

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

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

Требования

Заголовок

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

См. также

KSNODEPROPERTY