KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR

KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR 속성은 모든 거리 값에 적용해야 하는 거리 요소를 지정합니다.

사용 요약 테이블

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

속성 값(작업 데이터)은 FLOAT 형식이며 거리 요소를 지정합니다.

반환 값

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

설명

KSPROPSETID_DirectSound3DBuffer 및 KSPROPSETID_DirectSound3DListener 속성에 대한 거리는 거리 계수의 미터 단위로 표현됩니다.

기본적으로 거리 계수는 1이고 거리는 미터 단위로 표현됩니다. (또한 기본 속도 단위는 초당 미터입니다.)

클라이언트는 다른 거리 요소를 지정하는 KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR set-property 요청을 전송하여 KSPROPSETID_DirectSound3DBuffer 및 KSPROPSETID_DirectSound3DListener 속성의 거리 단위를 변경할 수 있습니다.

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

요구 사항

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

참고 항목

KSNODEPROPERTY