IAudioEndpointVolume::VolumeStepUp 메서드(endpointvolume.h)

VolumeStepUp 메서드는 오디오 엔드포인트 디바이스에 들어오거나 나가는 오디오 스트림의 볼륨 수준을 한 단계씩 증가합니다.

구문

HRESULT VolumeStepUp(
  [in] LPCGUID pguidEventContext
);

매개 변수

[in] pguidEventContext

IAudioEndpointVolumeCallback::OnNotify 메서드의 컨텍스트 값입니다. 이 매개 변수는 이벤트 컨텍스트 GUID를 가리킵니다. VolumeStepUp 호출이 엔드포인트의 볼륨 수준을 변경하면 해당 엔드포인트에 IAudioEndpointVolumeCallback 인터페이스를 등록한 모든 클라이언트가 알림을 받습니다. OnNotify 메서드 구현에서 클라이언트는 이벤트 컨텍스트 GUID를 검사하여 이벤트 컨텍스트 GUID 또는 다른 클라이언트가 볼륨 변경 이벤트의 원본인지 여부를 검색할 수 있습니다. 호출자가 이 매개 변수에 대한 NULL 포인터를 제공하는 경우 클라이언트의 알림 메서드는 NULL 컨텍스트 포인터를 받습니다.

반환 값

메서드가 성공하면 S_OK가 반환되고, 실패할 경우 가능한 반환 코드는 다음 표에 표시된 값을 포함하지만 이에 국한되지 않습니다.

반환 코드	설명
E_OUTOFMEMORY	메모리가 부족합니다.

설명

현재 볼륨 단계와 볼륨 범위의 총 단계 수를 가져오려면 IAudioEndpointVolume::GetVolumeStepInfo 메서드를 호출합니다.

볼륨 수준이 이미 볼륨 범위에서 가장 높은 단계에 있는 경우 VolumeStepUp에 대한 호출은 효과가 없으며 코드 S_OK 상태 반환합니다.

인접 단계 간의 연속 간격이 반드시 선형 신호 진폭 또는 데시벨에서 균일한 볼륨 증분을 나타내는 것은 아닙니다. Windows Vista에서 VolumeStepUp 은 볼륨 수준(신호 진폭)에 대한 단계 인덱스의 관계를 오디오 테이퍼 곡선으로 정의합니다. 곡선의 모양은 이후 버전의 Windows에서 변경될 수 있습니다. 오디오 테이퍼 곡선에 대한 자세한 내용은 오디오 테이퍼 볼륨 컨트롤을 참조하세요.

요구 사항

지원되는 최소 클라이언트	Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	endpointvolume.h

추가 정보

IAudioEndpointVolume 인터페이스

IAudioEndpointVolume::GetVolumeStepInfo

IAudioEndpointVolumeCallback 인터페이스

IAudioEndpointVolumeCallback::OnNotify