EndpointVolume

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

本主题包含以下各节：

• 描述
• 要求
• 下载示例
• 生成示例
• 运行示例
• 相关主题

说明

此示例演示了以下功能。

• 用于多媒体设备枚举和选择的 MMDevice API。
• 用于控制设备终结点音量水平的 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 示例