IAudioEndpointVolume::GetVolumeStepInfo 메서드(endpointvolume.h)
GetVolumeStepInfo 메서드는 볼륨 범위의 현재 단계에 대한 정보를 가져옵니다.
구문
HRESULT GetVolumeStepInfo(
[out] UINT *pnStep,
[out] UINT *pnStepCount
);
매개 변수
[out] pnStep
메서드가 현재 단계 인덱스를 작성하는 UINT 변수에 대한 포인터입니다. 이 인덱스는 0에서 *pStepCount– 1까지의 범위의 값입니다. 여기서 0은 최소 볼륨 수준을 나타내고 *pStepCount – 1은 최대 수준을 나타냅니다.
[out] pnStepCount
메서드가 볼륨 범위의 단계 수를 쓰는 UINT 변수에 대한 포인터입니다. 이 숫자는 IAudioEndpointVolume 인터페이스 instance 수명 동안 일정하게 유지됩니다.
반환 값
메서드가 성공하면 S_OK가 반환되고, 실패할 경우 가능한 반환 코드에는 다음 표에 표시된 값이 포함되지만 이에 국한되지는 않습니다.
| 반환 코드 | 설명 |
|---|---|
|
매개 변수 pnStep 및 pnStepCount는 모두 NULL입니다. |
설명
이 메서드는 오디오 엔드포인트 디바이스에 들어오거나 나가는 오디오 스트림의 볼륨 수준을 불연속 볼륨 수준의 범위에서 인덱스 또는 "단계"로 나타냅니다. 출력 값 *pnStepCount 는 범위의 단계 수입니다. 출력 값 *pnStep 은 현재 볼륨 수준의 단계 인덱스입니다. 단계 수가 n = *pnStepCount이면 단계 인덱스 *pnStep 은 값을 0(최소 볼륨)에서 n – 1(최대 볼륨)으로 가정할 수 있습니다.
0에서 n – 1 사이의 범위에서 인접 단계 간의 연속 간격이 반드시 선형 신호 진폭 또는 데시벨의 균일한 볼륨 증분을 나타내는 것은 아닙니다. Windows Vista에서 GetVolumeStepInfo 는 인덱스와 볼륨 수준(신호 진폭)의 관계를 오디오 테이퍼 곡선으로 정의합니다. 곡선의 모양은 이후 버전의 Windows에서 변경될 수 있습니다. 오디오 테이퍼 곡선에 대한 자세한 내용은 오디오 테이퍼 볼륨 컨트롤을 참조하세요.
오디오 애플리케이션은 IAudioEndpointVolume::VolumeStepUp 및 IAudioEndpointVolume::VolumeStepDown 메서드를 호출하여 볼륨 수준을 한 간격으로 늘리거나 줄일 수 있습니다. 두 방법 모두 먼저 오디오 테이퍼 곡선의 다음 지점에 해당하는 이상적인 볼륨 수준을 계산합니다. 다음으로, 메서드는 이상적인 수준에 가장 적합한 엔드포인트 볼륨 설정을 선택합니다. 엔드포인트 볼륨 설정의 범위와 세분성을 가져오려면 IEndpointVolume::GetVolumeRange 메서드를 호출합니다. 오디오 엔드포인트 디바이스가 하드웨어 볼륨 컨트롤을 구현하는 경우 GetVolumeRange 는 하드웨어 볼륨 설정을 설명합니다. 그렇지 않으면 EndpointVolume API는 소프트웨어에서 엔드포인트 볼륨 제어를 구현하고 GetVolumeRange 는 소프트웨어 구현 컨트롤의 볼륨 설정을 설명합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | endpointvolume.h |