EndpointVolume

此範例應用程式會使用核心音訊 API 來變更裝置的音量，如使用者所指定。

本主題包含下列各節。

• 說明
• 需求
• 下載範例
• 建置範例
• 執行範例
• 相關主題

描述

此範例示範下列功能。

• 多媒體裝置列舉和選取的MMDevice API 。
• EndpointVolume API 來控制裝置端點的磁碟區層級。

需求

Products	版本
Windows SDK	Windows 7
Visual Studio	2008

 

下載範例

此範例可在下列位置取得。

Location	路徑/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

下表顯示自變數。

Argument	描述
-?	顯示說明。
-h	顯示說明。
-+	將音訊端點裝置上的音量層級遞增一個步驟。 .
-up	將音訊端點裝置上的音量層級遞增一個步驟。
--	將音訊端點裝置上的音量層級遞減一個步驟。
-down	將音訊端點裝置上的音量層級遞減一個步驟。
-v	在音訊端點裝置上設定主要音量層級。
-安慰	使用預設主控台裝置。
-通信	使用預設通訊裝置。
-多媒體	使用預設多媒體裝置。
-端點	使用參數值中指定的端點標識碼。

 

如果應用程式在沒有自變數的情況下執行，它會列舉可用的裝置，並提示使用者選取裝置。 在使用者指定裝置之後，應用程式會顯示端點目前的磁碟區設定。 您可以使用上表所述的參數來控制磁碟區。

如需控制音頻端點裝置音量層級的詳細資訊，請參閱 EndpointVolume API。

相關主題

使用核心音訊 API 的 SDK 範例