다음을 통해 공유


KSPROPERTY_AUDIO_EQ_LEVEL

KSPROPERTY_AUDIO_EQ_LEVEL 속성은 n 빈도 대역에 대한 항목을 포함하는 균등화 테이블의 균등화 수준을 지정합니다. EQ 노드(KSNODETYPE_EQUALIZER)에 있는 채널의 속성입니다.

사용량 요약 테이블

가져오기 설정 대상 속성 설명자 형식 속성 값 형식

Yes

Yes

필터

KSNODEPROPERTY_AUDIO_CHANNEL

LONG 배열

속성 값(작업 데이터)은 LONG 요소의 배열입니다.

  LONG  Level[N];

채널의 균등화 테이블에 N 빈도 대역에 대한 항목이 포함된 경우 배열에는 N 요소가 포함되고 각 요소는 이퀄라이제이션 테이블의 밴드 중 하나에 대한 수준을 지정합니다. 배열 요소에 대한 대역 할당은 다음 표에 나와 있습니다.

Array 요소 설명 수준[0]

밴드 0의 수준입니다.

수준[1]

밴드 1의 수준입니다.

...

수준[N-1]

밴드 N-1에 대한 수준입니다.

수준 값은 다음 배율을 사용합니다.

-2147483648 -Infinity 데시벨(감쇠)입니다.

-2147483647 -32767.99998474 데시벨(감쇠) 및

+2147483647 +32767.99998474 데시벨(게인)입니다.

정수 값으로 표시되는 데시벨 범위 -2147483648 ~+2147483647. 여기서

이 배율의 해상도는 1/65536 데시벨입니다.

반환 값

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

설명

필터는 필터 범위를 벗어나지만 값을 지원되는 범위로 고정하는 값을 지정하는 KSPROPERTY_AUDIO_EQ_LEVEL set-property 요청에 성공합니다. 그러나 이 속성을 가져오는 후속 요청에서는 사용된 실제 값을 출력합니다.

이퀄라이제이션 대역의 수는 먼저 KSPROPERTY_AUDIO_NUM_EQ_BANDS 요청을 제출하여 확인할 수 있습니다.

이퀄라이제이션 대역의 중심 주파수는 KSPROPERTY_AUDIO_EQ_BANDS 속성에 의해 지정됩니다.

요구 사항

헤더

Ksmedia.h(Ksmedia.h 포함)

참고 항목

KSNODEPROPERTY_AUDIO_CHANNEL

KSNODETYPE_EQUALIZER

KSPROPERTY_AUDIO_NUM_EQ_BANDS

KSPROPERTY_AUDIO_EQ_BANDS