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 示例，请使用以下步骤：
- 打开 Windows SDK 的 CMD shell 并更改为 EndpointVolume 示例目录。
- 在 EndpointVolume 目录中
start EndpointVolumeChanger.sln运行以下命令，在 Visual Studio 窗口中打开 EndpointVolumeChanger 项目。 - 在窗口中，选择 调试 或 发布 解决方案配置，从菜单栏中选择 生成 菜单，然后选择 生成 选项。 如果未从 SDK 的 CMD shell 打开 Visual Studio，Visual Studio 将无法访问 SDK 生成环境。 在这种情况下，除非显式设置在项目文件 WASAPIEndpointVolume.vcproj 中使用的环境变量 MSSdk，否则此示例不会生成。
运行示例
如果成功生成演示应用程序，则会生成可执行文件 EndpointVolumeChanger.exe。 若要运行它，请在命令窗口中键入 EndpointVolumeChanger，后跟必需或可选参数。 以下示例演示如何在默认控制台设备上切换静音设置。
EndpointVolumeChanger.exe -console -m
下表显示了参数。
| 论点 | 描述 |
|---|---|
| -? | 显示帮助。 |
| -h | 显示帮助。 |
| -+ | 将音频终结点设备上的音量级别递增一步。 . |
| -向上 | 将音频终结点设备上的音量级别递增一步。 |
| -- | 将音频终结点设备上的音量级别递减一步。 |
| -下 | 将音频终结点设备上的音量级别递减一步。 |
| -v | 在音频终结点设备上设置主音量级别。 |
| -安慰 | 使用默认控制台设备。 |
| -通信 | 使用默认通信设备。 |
| -多媒体 | 使用默认多媒体设备。 |
| -端点 | 使用开关值中指定的终结点标识符。 |
如果应用程序在没有参数的情况下运行，它将枚举可用的设备，并提示用户选择设备。 用户指定设备后，应用程序会显示终结点的当前卷设置。 可以使用上表中所述的开关来控制卷。
有关控制音频终结点设备的音量级别的详细信息，请参阅 EndpointVolume API。
相关主题
-
使用核心音频 API 的 SDK 示例