EndpointVolume

В этом примере приложения используются API Core Audio для изменения тома устройства, указанного пользователем.

Эта тема описана в следующих разделах.

• Description
• Требования
• Скачивание примера
• Создание примера
• Запуск примера
• Связанные статьи

Description

В этом примере показаны следующие функции.

• API MMDevice для перечисления и выбора мультимедийных устройств.
• API EndpointVolume для управления уровнями томов конечной точки устройства.

Требования

Продукт	Версия
Windows SDK	Windows 7
Visual Studio	2008

 

Скачивание примера

Этот пример доступен в следующих расположениях.

Расположение	Путь или URL-адрес
Пакет Windows SDK	\Program Files\Microsoft SDKs\Windows\v7.0\Samples\Multimedia\Audio\EndpointVolume\...

 

Построение образца

Чтобы создать пример x, выполните следующие действия.

Чтобы создать пример EndpointVolumeChanger, выполните следующие действия.

1. Откройте оболочку CMD для пакета SDK для Windows и перейдите в пример каталога EndpointVolume.
2. Выполните команду start EndpointVolumeChanger.sln в каталоге EndpointVolume, чтобы открыть проект EndpointVolumeChanger в окне Visual Studio.
3. В окне выберите конфигурацию решения отладки или выпуска, выберите меню "Сборка" в строке меню и выберите параметр "Сборка". Если вы не открываете Visual Studio из оболочки CMD для пакета SDK, Visual Studio не будет иметь доступа к среде сборки пакета SDK. В этом случае пример не будет создаваться, если вы явно не задали переменную среды MSSdk, которая используется в файле проекта WASAPIEndpointVolume.vcproj.

Запуск примера

При успешной сборке демонстрационного приложения создается исполняемый файл, EndpointVolumeChanger.exe. Чтобы запустить его, введите EndpointVolumeChanger в командном окне, за которым следует обязательные или необязательные аргументы. В следующем примере показано, как переключить параметр отключения звука на устройстве консоли по умолчанию.

EndpointVolumeChanger.exe -console -m

В следующей таблице показаны аргументы.

Аргумент	Description
-?	Отображает справку.
-h	Отображает справку.
-+	Увеличивает уровень громкости на устройстве конечной точки аудио на один шаг. .
-up	Увеличивает уровень громкости на устройстве конечной точки аудио на один шаг.
--	Уменьшает уровень громкости на устройстве конечной точки аудио на один шаг.
-Вниз	Уменьшает уровень громкости на устройстве конечной точки аудио на один шаг.
-v	Задает уровень основного тома на устройстве звуковой конечной точки.
-Консоли	Используйте консольное устройство по умолчанию.
-Коммуникаций	Используйте устройство связи по умолчанию.
-Мультимедиа	Используйте мультимедийное устройство по умолчанию.
-Конечной точки	Используйте идентификатор конечной точки, указанный в значении коммутатора.

 

Если приложение выполняется без аргументов, оно перечисляет доступные устройства и предложит пользователю выбрать устройство. После указания устройства приложение отображает текущие параметры тома для конечной точки. Том можно контролировать с помощью коммутаторов, описанных в предыдущей таблице.

Дополнительные сведения об управлении уровнями томов устройств конечной точки звука см. в API EndpointVolume.

См. также

Примеры пакета SDK, использующие основные API аудио