EndpointVolume
이 샘플 애플리케이션은 핵심 오디오 API를 사용하여 사용자가 지정한 대로 디바이스의 볼륨을 변경합니다.
이 항목에는 다음과 같은 섹션이 포함되어 있습니다.
설명
이 샘플에서는 다음 기능을 보여 줍니다.
- 멀티미디어 디바이스 열거 및 선택용 MMDevice API.
- EndpointVolume API - 디바이스 엔드포인트의 볼륨 수준을 제어합니다.
요구 사항
| 제품 | 버전 |
|---|---|
| Windows SDK | Windows 7 |
| Visual Studio | 2008 |
샘플 다운로드
이 샘플은 다음 위치에서 사용할 수 있습니다.
| 위치 | Path/URL |
|---|---|
| Windows SDK | \Program Files\Microsoft SDKs\Windows\v7.0\Samples\Multimedia\Audio\EndpointVolume\... |
예제 빌드
x 샘플을 빌드하려면 다음 단계를 사용합니다.
EndpointVolumeChanger 샘플을 빌드하려면 다음 단계를 사용합니다.
- Windows SDK용 CMD 셸을 열고 EndpointVolume 샘플 디렉터리로 변경합니다.
- EndpointVolume 디렉터리에서 명령을
start EndpointVolumeChanger.sln실행하여 Visual Studio 창에서 EndpointVolumeChanger 프로젝트를 엽니다. - 창 내에서 디버그 또는 릴리스 솔루션 구성을 선택하고 메뉴 모음에서 빌드 메뉴를 선택하고 빌드 옵션을 선택합니다. SDK용 CMD 셸에서 Visual Studio를 열지 않으면 Visual Studio는 SDK 빌드 환경에 액세스할 수 없습니다. 이 경우 프로젝트 파일 WASAPIEndpointVolume.vcproj에 사용되는 환경 변수 MSSdk를 명시적으로 설정하지 않으면 샘플이 빌드되지 않습니다.
샘플 실행
데모 애플리케이션을 성공적으로 빌드하면 실행 파일 EndpointVolumeChanger.exe 생성됩니다. 실행하려면 명령 창에 를 입력한 다음 필수 또는 선택적 인수를 입력 EndpointVolumeChanger 합니다. 다음 예제에서는 기본 콘솔 디바이스에서 음소거 설정을 토글하는 방법을 보여줍니다.
EndpointVolumeChanger.exe -console -m
다음 표에는 인수가 표시됩니다.
| 인수 | Description |
|---|---|
| -? | 도움말을 표시합니다. |
| -H | 도움말을 표시합니다. |
| -+ | 오디오 엔드포인트 디바이스의 볼륨 수준을 한 단계씩 증가합니다. . |
| -위쪽 | 오디오 엔드포인트 디바이스의 볼륨 수준을 한 단계씩 증가합니다. |
| -- | 오디오 엔드포인트 디바이스의 볼륨 수준을 한 단계 감소합니다. |
| -아래로 | 오디오 엔드포인트 디바이스의 볼륨 수준을 한 단계 감소합니다. |
| -v | 오디오 엔드포인트 디바이스에서 master 볼륨 수준을 설정합니다. |
| -콘솔 | 기본 콘솔 디바이스를 사용합니다. |
| -통신 | 기본 통신 디바이스를 사용합니다. |
| -멀티미디어 | 기본 멀티미디어 디바이스를 사용합니다. |
| -끝점 | 스위치 값에 지정된 엔드포인트 식별자를 사용합니다. |
애플리케이션이 인수 없이 실행되는 경우 사용 가능한 디바이스를 열거하고 사용자에게 디바이스를 선택하라는 메시지를 표시합니다. 사용자가 디바이스를 지정한 후 애플리케이션은 엔드포인트에 대한 현재 볼륨 설정을 표시합니다. 이전 표에 설명된 스위치를 사용하여 볼륨을 제어할 수 있습니다.
오디오 엔드포인트 디바이스의 볼륨 수준을 제어하는 방법에 대한 자세한 내용은 EndpointVolume API를 참조하세요.
관련 항목