EndpointVolume

此示例应用程序使用核心音频 API 来更改用户指定的设备音量。

本主题包含以下各节:

说明

此示例演示了以下功能。

要求

产品 版本
Windows SDK Windows 7
Visual Studio 2008 年

 

下载示例

此样本在以下位置提供。

位置 路径/URL
Windows SDK \Program Files\Microsoft SDKs\Windows\v7.0\Samples\Multimedia\Audio\EndpointVolume\...

 

生成示例

要生成 x 示例,请执行以下步骤:

要生成 EndpointVolumeChanger 示例,请执行以下步骤:

  1. 打开 Windows SDK 的 CMD shell,并更改为 EndpointVolume 示例目录。
  2. 在 EndpointVolume 目录下运行 start EndpointVolumeChanger.sln 命令,以便在 Visual Studio 窗口中打开 EndpointVolumeChanger 项目。
  3. 在窗口中选择“调试”或“发布”解决方案配置,从菜单栏中选择“生成”菜单,然后选择“生成”选项。 如果未从 SDK 的 CMD shell 打开 Visual Studio,则 Visual Studio 将无法访问 SDK 的生成环境。 在这种情况下,除非显式设置了项目文件 WASAPIEndpointVolume.vcproj 中使用的环境变量 MSSdk,否则将无法生成此示例。

运行示例

如果成功生成演示应用程序,则会生成一个可执行文件 EndpointVolumeChanger.exe。 要运行它,请在命令窗口中键入 EndpointVolumeChanger,然后输入必要或可选的参数。 以下示例显示了如何切换默认控制台设备上的静音设置。

EndpointVolumeChanger.exe -console -m

下表列出了参数。

参数 说明
-? 显示帮助。
-h 显示帮助。
-+ 将音频终结点设备的音量递增一步。 。
-up 将音频终结点设备的音量递增一步。
-- 将音频终结点设备的音量递减一步。
-down 将音频终结点设备的音量递减一步。
-v 设置音频终结点设备的主音量水平。
-console 使用默认控制台设备。
-communications 使用默认通信设备。
-multimedia 使用默认多媒体设备。
-endpoint 使用开关值中指定的终结点标识符。

 

如果不带参数运行应用程序,它会枚举可用设备并提示用户选择设备。 在用户指定设备后,应用程序会显示终结点的当前音量设置。 音量可通过上表中的开关来加以控制。

有关控制音频终结点设备音量水平的详细信息,请参阅 EndpointVolume API

使用核心音频 API 的SDK 示例