KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR

KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR 속성은 3D 수신기의 롤오프 요소를 지정합니다.

사용량 요약 테이블

가져오기	설정	대상	속성 설명자 형식	속성 값 형식
Yes	Yes	Pin	KSNODEPROPERTY	FLOAT

속성 값(작업 데이터)은 FLOAT 형식이며 롤오프 인수를 지정합니다. 롤오프 계수는 각각 0.0 및 10.0으로 정의된 DS3D_MINROLLOFFFACTOR부터 DS3D_MAXROLLOFFFACTOR 이르기까지 다양합니다. 기본 롤오프 요소는 1.0으로 정의된 DS3D_DEFAULTROLLOFFFACTOR.

반환 값

KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR 속성 요청은 성공적으로 완료되었음을 나타내는 STATUS_SUCCESS 반환합니다. 그렇지 않으면 요청은 코드에 적절한 오류 상태 반환합니다.

설명

롤오프는 사운드 소스에서 수신기의 거리에 따라 소리에 적용되는 감쇠의 양입니다. 롤오프 인수가 0이면 수신기와의 거리에 관계없이 감쇠가 사운드에 적용되지 않습니다. 1보다 큰 요소는 거리와 소리의 실제 감쇠를 과장.

DirectSound는 이 속성을 사용하여 Microsoft Windows SDK 설명서에 설명된 IDirectSound3DListener::GetRolloffFactor 및 IDirectSound3DListener::SetRolloffFactor 메서드를 구현합니다.

요구 사항

헤더	Ksmedia.h(Ksmedia.h 포함)

참고 항목

KSNODEPROPERTY