KSPROPERTY_AUDIOENGINE_VOLUMELEVEL
KSPROPERTY_AUDIOENGINE_VOLUMELEVEL 속성은 지정된 스트림에 있는 채널의 볼륨 수준을 지정합니다.
사용 요약 테이블
| 가져오기 | 설정 | 대상 | 속성 설명자 형식 | 속성 값 형식 |
|---|---|---|---|---|
Yes |
Yes |
고정 instance 통해 노드 |
LONG(Get 요청의 경우) 및 KSAUDIOENGINE_VOLUMELEVEL (Set 요청의 경우). |
Get 요청의 경우 속성 값은 LONG 형식이며 지정된 스트림에서 채널의 볼륨 수준을 지정합니다. 볼륨 수준 값은 다음 배율을 사용하며 이 속성에 대한 기본 지원 응답에 제공된 최소값과 최대값으로 제한될 수 있습니다.
-2147483648(16진수 또는 LONG_MIN 0x80000000)는 -Infinity 데시벨(감쇠)입니다.
-2147483647(0x80000001 16진수 또는 LONG_MIN + 1)는 -32767.99998474 데시벨(감쇠)입니다.
+2147483647(16진수 또는 LONG_MAX 0x7FFFFFFF)는 +32767.99998474 데시벨(게인)입니다.
참고
decibel 범위는 -2147483648 ~+2147483647 정수 값으로 표현됩니다. 여기서 이 배율의 해상도는 1/65536 데시벨입니다.
Set 요청의 경우 속성 값은 KSAUDIOENGINE_VOLUMELEVEL 형식이며 지정된 스트림에 있는 채널의 원하는 볼륨 수준과 볼륨 수준이 설정될 때 적용할 곡선 유형 및 곡선 기간을 지정합니다. 필터 범위를 벗어나 값이 지정되면 이 속성을 설정하라는 요청이 계속 성공합니다. 그러나 필터에 적용된 실제 값은 이 속성에 대한 후속 Get 호출에서만 확인할 수 있습니다.
반환 값
KSPROPERTY_AUDIOENGINE_SUPPORTEDDEVICEFORMATS 속성 요청은 성공적으로 완료되었음을 나타내는 STATUS_SUCCESS 반환합니다. 그렇지 않으면 요청이 적절한 오류 상태 코드를 반환합니다.
설명
KSPROPERTY_AUDIOENGINE_VOLUMELEVEL 속성 설명자는 채널 번호를 지정합니다. 오디오 엔진 노드를 통과하는 스트림에 n 채널이 포함된 경우 채널 번호는 0 부터 n-1까지입니다. 또한 0xFFFFFFFF 채널 값은 요청이 모든 채널에 적용됨을 나타냅니다. 스트림이 실행 중 상태가 아닌 동안 속성 요청이 이루어지면 볼륨 수준이 요청된 수준으로 즉시 설정됩니다. 볼륨 수준 램프가 진행되는 동안 스트림이 실행 상태를 벗어나면 스트림의 볼륨 수준이 현재 페이드의 대상 수준으로 즉시 설정됩니다. 기존 볼륨 수준 램프가 진행되는 동안 새 속성 요청이 이루어지는 경우 새 요청이 도착했을 때 볼륨이 도달한 수준인 현재 볼륨 수준에서 새 램프 요청이 시작되어야 합니다.
요구 사항
Version |
Windows 8 |
헤더 |
Ksmedia.h |