델파이로 Windows 볼륨 조절하고 바깥 변경까지 따라가기 — VolumeControl
Core Audio(WASAPI)로 Windows 전체 볼륨과 앱 볼륨을 조절하고, 볼륨 믹서나 볼륨 키로 바뀐 값도 화면에 반영하는 Delphi VCL 예제입니다.
프로그램 안에 볼륨 슬라이더를 두는 것까지는 어렵지 않습니다. 곤란한 건 사용자가 키보드 볼륨 키나 Windows 볼륨 믹서로 값을 바꿨을 때입니다. 프로그램의 슬라이더는 예전 값에 머물러 있고, 두 값이 어긋납니다.
VolumeControl은 Core Audio(WASAPI) API로 볼륨을 조절하면서, 바깥에서 일어난 변경도 받아서 트랙바를 실시간으로 움직이는 Delphi(VCL) 예제입니다.

무엇을 하나
인터페이스 하나(IVolumeControl)로 두 가지 볼륨을 다룹니다.
| 볼륨 | 내용 | 쓰는 API |
|---|---|---|
| 전체(마스터) 볼륨 | 기본 출력 장치의 전체 볼륨 | IAudioEndpointVolume |
| 앱 볼륨 | 이 프로세스의 오디오 세션 볼륨. 볼륨 믹서에 앱별로 뜨는 그 슬라이더 | ISimpleAudioVolume |
그 밖에 이런 처리가 들어 있습니다.
IAudioEndpointVolumeCallback·IAudioSessionEvents를 등록해 시스템 어디서든 바뀐 볼륨과 음소거를 받습니다.- 값을 바꿀 때마다 고정 EventContext GUID를 넘기고, 콜백에서 이 값을 비교해 이 앱이 바꾼 것(
AExternal = False)인지 바깥에서 바꾼 것(AExternal = True)인지 가립니다. - 콜백은 오디오 시스템의 작업 스레드에서 오므로
TThread.Queue로 메인 스레드에 넘겨 화면을 고칩니다. NotifyDelayMs가0이면 바로 반영하고, 0보다 크면 변경이 멈춘 뒤 마지막 값만 한 번 알립니다.
어떻게 만들었나
Core Audio는 "드래그가 끝났다"는 신호를 주지 않고 값이 바뀔 때마다 알림을 보냅니다. 믹서 슬라이더를 끌면 알림이 쏟아집니다. 예제는 이렇게 처리합니다.
OnNotify·OnSimpleVolumeChanged가 Core Audio 작업 스레드에서 불립니다.- 최신 값을 잠금 아래 보관하고,
TThread.Queue로 작업을 하나만 넣습니다. - 메인 스레드에서
OnVolumeChanged·OnMuteChanged이벤트를 올립니다. - 폼이 트랙바를 고칠 때는 플래그로 막아, 코드로 바꾼
Position이 다시SetVolume을 부르지 않게 합니다.
쌓인 알림을 하나씩 처리하지 않으니 트랙바가 밀리지 않고 따라옵니다.
써 보기
var LVolume: IVolumeControl := CreateMasterVolume; // 또는 CreateAppVolume
LVolume.NotifyDelayMs := 0; // 0 = 즉시, > 0 = debounce(밀리초)
LVolume.OnVolumeChanged :=
procedure(Sender: TObject; APercent: Integer; AExternal: Boolean)
// ... 핸들러 ...
LVolume.Volume := 50; // 50% 로 설정
IDE에서 src/VolumeTest.dproj를 열어 빌드하거나, 명령줄 컴파일러를 씁니다.
"C:/Program Files (x86)/Embarcadero/Studio/37.0/bin/dcc64.exe" src/VolumeTest.dpr -B -E"BIN"
src/VolumeSmoke.dpr는 화면 없이 제어·알림·해제 경로를 점검하는 콘솔 테스트입니다. 실제로 가져다 쓸 부분은 src/Audio.Volume.pas 한 파일입니다.
COM 초기화
VolumeTest.dpr은 CoInitializeEx(nil, COINIT_APARTMENTTHREADED)를 먼저 부릅니다. 이 호출이 없으면 오디오 세션 알림을 등록할 때 COM 마샬링이 정해지지 않아, 앱 볼륨을 처음 바꿀 때 프로그램이 죽을 수 있습니다.
알아 둘 점
- Delphi 13(Embarcadero Studio 37.0) 또는 호환 버전, Windows Vista 이상이 필요합니다. 타깃 플랫폼은 Win64입니다.
- 라이선스는 MIT입니다.
소스는 GitHub 저장소에 있습니다.