Share via

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 샘플을 빌드하려면 다음 단계를 사용합니다.

  1. Windows SDK용 CMD 셸을 열고 EndpointVolume 샘플 디렉터리로 변경합니다.
  2. EndpointVolume 디렉터리에서 명령을 start EndpointVolumeChanger.sln 실행하여 Visual Studio 창에서 EndpointVolumeChanger 프로젝트를 엽니다.
  3. 창 내에서 디버그 또는 릴리스 솔루션 구성을 선택하고 메뉴 모음에서 빌드 메뉴를 선택하고 빌드 옵션을 선택합니다. SDK용 CMD 셸에서 Visual Studio를 열지 않으면 Visual Studio는 SDK 빌드 환경에 액세스할 수 없습니다. 이 경우 프로젝트 파일 WASAPIEndpointVolume.vcproj에 사용되는 환경 변수 MSSdk를 명시적으로 설정하지 않으면 샘플이 빌드되지 않습니다.

샘플 실행

데모 애플리케이션을 성공적으로 빌드하면 실행 파일 EndpointVolumeChanger.exe 생성됩니다. 실행하려면 명령 창에 를 입력한 다음 필수 또는 선택적 인수를 입력 EndpointVolumeChanger 합니다. 다음 예제에서는 기본 콘솔 디바이스에서 음소거 설정을 토글하는 방법을 보여줍니다.

EndpointVolumeChanger.exe -console -m

다음 표에는 인수가 표시됩니다.

인수 Description
-? 도움말을 표시합니다.
-H 도움말을 표시합니다.
-+ 오디오 엔드포인트 디바이스의 볼륨 수준을 한 단계씩 증가합니다. .
-위쪽 오디오 엔드포인트 디바이스의 볼륨 수준을 한 단계씩 증가합니다.
-- 오디오 엔드포인트 디바이스의 볼륨 수준을 한 단계 감소합니다.
-아래로 오디오 엔드포인트 디바이스의 볼륨 수준을 한 단계 감소합니다.
-v 오디오 엔드포인트 디바이스에서 master 볼륨 수준을 설정합니다.
-콘솔 기본 콘솔 디바이스를 사용합니다.
-통신 기본 통신 디바이스를 사용합니다.
-멀티미디어 기본 멀티미디어 디바이스를 사용합니다.
-끝점 스위치 값에 지정된 엔드포인트 식별자를 사용합니다.

 

애플리케이션이 인수 없이 실행되는 경우 사용 가능한 디바이스를 열거하고 사용자에게 디바이스를 선택하라는 메시지를 표시합니다. 사용자가 디바이스를 지정한 후 애플리케이션은 엔드포인트에 대한 현재 볼륨 설정을 표시합니다. 이전 표에 설명된 스위치를 사용하여 볼륨을 제어할 수 있습니다.

오디오 엔드포인트 디바이스의 볼륨 수준을 제어하는 방법에 대한 자세한 내용은 EndpointVolume API를 참조하세요.

핵심 오디오 API를 사용하는 SDK 샘플